Download OpenAPI specification:
APIを利用するには、APIトークンを発行する必要があります。
トークンを Authorization: Bearer ヘッダーに付加してリクエストを送信してください。
トークンは HERP Hire for Agents の APIトークン ページより発行できます。（ログインが必要です）
HERP HireではAPIアクセスを アカウントごと に1分間10リクエストまでに制限しています。
APIのレスポンスヘッダーには以下のアクセス情報が付加されます。
x-remaining-request: 9 # 期間内にリクエストできる残りの回数
x-reset-at: 2025-03-24T00:00:00+09:00 # 残り回数がリセットされる時刻
レスポンスのステータスコードは以下のように解釈されます。
| ステータスコード | 説明 |
|---|---|
| 200 | 正常なレスポンス |
| 400 | パラメーターに不備があった |
| 401 | 認証に失敗した |
| 403 | アクセス権限がない |
| 404 | 存在しないリソースにアクセスした |
| 429 | アクセス回数が制限を超えた |
| 500 | サーバー側で予期しないエラーが発生した |
[- {
- "id": "string",
- "requisitionPublicProperties": {
- "name": "string",
- "summary": "string",
- "requiredSkills": "string",
- "preferredSkills": "string",
- "personality": "string",
- "salary": "string",
- "location": "string",
- "formOfEmployment": "string",
- "workingConditions": "string",
- "trial": "string",
- "welfare": "string",
- "others": "string",
- "employmentType": [
- "regular_employee"
], - "textType": "text/plain"
}, - "requisitionInfoForAgent": {
- "background": "string",
- "target": "string",
- "fixedNumber": "string",
- "selectionFlow": "string",
- "period": "string",
- "treatment": "string",
- "priority": "string"
}, - "company": {
- "name": "string",
- "id": "string"
}, - "urls": [
- {
- "agent": {
- "name": "string",
- "companyName": "string"
}, - "url": "string"
}
]
}
]