Endpoint
| field | value |
|---|
| method | POST |
| path | /api/integrations/v1/companies/{company_id}/employees/bulk-upsert |
| operationId | bulk_upsert_employees_for_integration |
| auth | server to server integration client token |
| Idempotency-Key | required |
| lifecycle | stable |
| resource type | employee |
| data classification | confidential |
| scope risk | medium |
| write operation | yes |
Summary
職員 の bulk upsert endpoint です。backend OpenAPI から同期しています。
Required scope
| scope | requirement |
|---|
| employees:write | required |
Operation contract
| field | value |
|---|
| bulk mode | bulk-upsert |
| bulk max items | 100 |
| bulk dry run | supported |
| sync type | - |
| sync max limit | - |
| reconciliation | - |
Path parameters
| name | required | schema |
|---|
| company_id | required | integer |
Query parameters
Header parameters
| name | required | schema |
|---|
| Idempotency-Key | required | string |
Request body
| status | media type | schema |
|---|
| - | application/json | IntegrationEmployeeBulkUpsertRequest |
Response
| status | media type | schema |
|---|
| 200 | application/json | SuccessResponse_IntegrationEmployeeBulkUpsertResponse_ |
Example
curl -X POST "https://api.anshin.care/api/integrations/v1/companies/{company_id}/employees/bulk-upsert" \
-H "Authorization: Bearer $ANSHIN_INTEGRATION_ACCESS_TOKEN" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-H "Content-Type: application/json" \
-d '{"example":"replace with request schema"}'
業務境界
- domain: 職員
- endpoint は各 backend の S2S scoped OpenAPI artifact から同期しています。
- company 境界は backend で検証します。
- write 系 endpoint は、画面用 API と endpoint を分け、処理本体は service 層で共通化します。