app

Anshin App API

現行backendの公開定義に基づくApp APIの操作ガイドです。法人のAPI key管理、業務データの同期、外部ID照合・監査を収録しています。提供済みの操作と、画面から利用するAPI未提供項目を分けて確認できます。

Scope groups

12 件

収録項目（未提供を含む）

73 件

Base URL

https://api.anshin.care

API提供済み 65 件 / API未提供 8 件

管理者のログインで行うAPI key管理と、連携用トークンで行う業務データ操作は認証が異なります。まず法人のAPI key設定と自己確認APIを確認してください。

API keyの準備接続・権限の自己確認

未提供項目には呼び出せるAPIがありません。項目内の画面操作ガイドをご利用ください。

API artifact coverage

operations

65

write APIs

43

idempotency

91%

high risk

9

Data classification

confidential: 24
internal: 33
restricted: 8

Scope risk

high: 5
low: 17
medium: 35
none: 8

スコープ別 API

業務分類を選び、項目一覧から必要な操作の説明を開いてください。

スコープAPI 項目

法人API提供済み 8 件 / API未提供 3 件11 件事業所API提供済み 10 件 / API未提供 0 件10 件事業所サービスAPI提供済み 10 件 / API未提供 0 件10 件ご利用者API提供済み 12 件 / API未提供 0 件12 件職員API提供済み 12 件 / API未提供 0 件12 件ご利用者アセスメントAPI提供済み 0 件 / API未提供 1 件1 件ご利用者サービス計画書API提供済み 0 件 / API未提供 1 件1 件予定・実績API提供済み 0 件 / API未提供 1 件1 件プロジェクトAPI提供済み 10 件 / API未提供 0 件10 件プランAPI提供済み 0 件 / API未提供 1 件1 件投稿API提供済み 0 件 / API未提供 1 件1 件連携運用API提供済み 3 件 / API未提供 0 件3 件

表示：12 件

POST /integrations/v1/companies/{company_id}/employees/bulk

職員を複数件まとめて新規登録します。行ごとの結果を確認しながら同期する処理に利用します。

API提供済み

分類: guide
scope: app
業務分類: employees
endpoint: POST /integrations/v1/companies/{company_id}/employees/bulk

このAPIでできること

職員を複数件まとめて新規登録します。行ごとの結果を確認しながら同期する処理に利用します。

実行前の準備

有効な連携clientのトークンを使います。対象法人とclientの法人が一致し、必要な権限がallowedScopesとtokenScopesの両方に含まれていることを確認します。書き込みを許可するclientには有効な実行者職員の設定が必要です。

itemsには1件以上、最大100件の業務データを入れます。最初はdryRun: trueで検証します。入力例の空配列は構造の例であり、そのまま送信できません。

Idempotency-Keyが必須です。同じ処理の通信再試行は同じキー・URL・入力で行い、入力を変更する場合やdryRunから実更新へ進む場合は新しいキーを用います。同じキーで異なる入力を送ると409になります。

結果の確認

HTTP 200だけで全件成功と判断せず、data.failed・succeededとitems各行のstatus、action、errorを確認します。dryRunでは変更を保存しません。実更新では成功行を二重登録せず、失敗行を修正して新しいキーで送信します。

失敗時の確認

401はトークンの期限・発行先・認証方式、403は対象法人・権限・clientの状態・実行者設定、404は対象IDと停止状態、409は紐付け又は再送内容、422は入力の必須項目・制約を確認します。応答のrequestIdは秘密値を含めず問い合わせ時の照合に使います。

行ごとの失敗を返すため、一部だけ成功する場合があります。外部IDの重複、停止済みの紐付け、参照先の不在を解消してから再実行します。

API定義の読み方

以下に現行OpenAPIから生成した認証、権限、入力、応答、cURLをまとめています。例のID・必須値・配列は実際の対象に置き換えてください。API keyの設定画面は準備の参考例であり、このAPIの実行結果ではありません。法人のAPI key設定画面で連携設定を確認できます。

認証の共通仕様 / エラー応答

POST/integrations/v1/companies/{company_id}/employees/bulk

職員を複数件まとめて新規登録します。行ごとの結果を確認しながら同期する処理に利用します。

Auth

Integration token

Idempotency-Key

required

Scopes

1 required

operationId

bulk_create_employees_for_integration

Lifecycle

stable

Risk

medium

Classification

confidential

Resource

employee

Required Scope

required

employees:write

optional

employees:contact:read

conditional

employees:credentials:writerequest includes login credential fields / risk: high

Parameters

name	in	required	schema
company_id	path	required	integer
Idempotency-Key	header	required	string

Request

status	media type	schema
-	application/json	IntegrationEmployeeBulkCreateRequest dryRunbooleanoptional itemsarrayrequired items.externalIdstringrequired items.noLoginbooleanoptional items.emailstring \| nulloptional items.passwordstring \| nulloptional items.lastNamestringrequired items.firstNamestringrequired items.lastNameKanastringrequired items.firstNameKanastringrequired items.birthdaystringrequired items.genderinteger \| nulloptional items.joinDatestringrequired items.selectedBranchServiceIdsarrayoptional items.selectedBranchServiceExternalIdsarray \| nulloptional example `{ "dryRun": false, "items": [ { "externalId": 123, "noLogin": true, "email": "partner@example.com", "password": "string", "lastName": "サンプル", "firstName": "サンプル", "lastNameKana": "サンプル", "firstNameKana": "サンプル", "birthday": "2026-07-21", "gender": 123, "joinDate": "2026-07-21", "selectedBranchServiceIds": [ 123 ], "selectedBranchServiceExternalIds": "partner-resource-123" } ] }`

Response

status	media type	schema
200	application/json	SuccessResponse_IntegrationEmployeeBulkCreateResponse_ successbooleanrequired成功フラグ (True=成功) dataIntegrationEmployeeBulkCreateResponse \| nullrequiredレスポンス本体データ data.dryRunbooleanrequired data.totalintegerrequired data.succeededintegerrequired data.failedintegerrequired data.itemsarrayrequired data.items.indexintegerrequired data.items.externalIdstringrequired data.items.statusstringrequired data.items.actionstringrequired data.items.idinteger \| nulloptional data.items.dataIntegrationEmployeeDetail \| nulloptional data.items.errorIntegrationErrorDetail \| nulloptional request_idstring \| nullrequired関連リクエストID (オプトイン有効時のみ) metaPaginationMeta \| nullrequiredページネーション情報 meta.limitintegerrequiredMaximum number of items requested meta.offsetintegerrequiredNumber of items skipped from the start meta.totalintegerrequiredTotal number of items matching the query

Operation Contract

write operation	yes
bulk mode	bulk-create
bulk max items	100
bulk dry run	supported
sync type	-
sync max limit	-
reconciliation	-

cURL

curl -X POST "https://api.anshin.care/api/integrations/v1/companies/{company_id}/employees/bulk" \
  -H "Authorization: Bearer $ANSHIN_INTEGRATION_ACCESS_TOKEN" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "dryRun": false,
  "items": [
    {
      "externalId": 123,
      "noLogin": true,
      "email": "partner@example.com",
      "password": "string",
      "lastName": "サンプル",
      "firstName": "サンプル",
      "lastNameKana": "サンプル",
      "firstNameKana": "サンプル",
      "birthday": "2026-07-21",
      "gender": 123,
      "joinDate": "2026-07-21",
      "selectedBranchServiceIds": [
        123
      ],
      "selectedBranchServiceExternalIds": "partner-resource-123"
    }
  ]
}'

実画面の参考例

無効サンプルの参照権限と実行者未設定の表示。 — 無効な架空clientの権限参照例です。APIの実行結果ではありません。有効な接続では設定側・トークン側の権限を/meで照合します。