app

Anshin App API

Anshin App API は、anshin-backend の S2S scoped OpenAPI artifact から同期した server to server endpoint reference です。credential 管理と integration API を同じ構成で確認できます。

Scope groups

12 件

API items

73 件

Base URL

https://api.anshin.care

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

業務スコープを選ぶと、right side contents に API 項目一覧を表示します。

スコープAPI 項目

法人11 API items11 件事業所10 API items10 件事業所サービス10 API items10 件ご利用者12 API items12 件職員12 API items12 件ご利用者アセスメント1 API items1 件ご利用者サービス計画書1 API items1 件予定・実績1 API items1 件プロジェクト10 API items10 件プラン1 API items1 件投稿1 API items1 件連携運用3 API items3 件

表示：12 件

PUT /integrations/v1/companies/{company_id}/customers/{customer_id}

Update ご利用者

公開中

分類: guide
scope: app
API group: update_customer_for_integration
endpoint: PUT /integrations/v1/companies/{company_id}/customers/{customer_id}

PUT/integrations/v1/companies/{company_id}/customers/{customer_id}

対象を更新します

Auth

Integration token

Idempotency-Key

required

Scopes

1 required

operationId

update_customer_for_integration

Lifecycle

stable

Risk

medium

Classification

confidential

Resource

customer

Required Scope

required

customers:write

optional

customers:contact:read

Parameters

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

Request

status	media type	schema
-	application/json	IntegrationCustomerUpdateRequest externalIdstring \| nulloptional typeintegerrequired lastNamestringrequired firstNamestringrequired lastNameKanastringrequired firstNameKanastringrequired birthdaystringrequired genderintegerrequired notesstring \| nulloptional phoneNumbersarray \| nulloptional phoneNumbers.idinteger \| nullrequiredID (識別子) phoneNumbers.phone_numberstring \| nullrequired番号 (識別子) phoneNumbers.labelstring \| nullrequired電話番号ラベル phoneNumbers.limit_onboolean \| nullrequired上限適用フラグ True=適用 phoneNumbers.certificatestring \| nullrequired証明書メモ phoneNumbers.certificate_datestring \| string \| nullrequired証明書日付 (YYYY-MM-DD HH:mm:ss) example `{ "externalId": 123, "type": 123, "lastName": "サンプル", "firstName": "サンプル", "lastNameKana": "サンプル", "firstNameKana": "サンプル", "birthday": "2026-07-21", "gender": 123, "notes": "string", "phoneNumbers": [ { "id": 123, "phone_number": "03-0000-0000", "label": "string", "limit_on": "string", "certificate": "string", "certificate_date": "string" } ] }`

Response

status	media type	schema
200	application/json	SuccessResponse_IntegrationCustomerDetail_ successbooleanrequired成功フラグ (True=成功) dataIntegrationCustomerDetail \| nullrequiredレスポンス本体データ data.idintegerrequired data.companyIdintegerrequired data.externalIdstring \| nulloptional data.typeinteger \| nulloptional data.emailstring \| nulloptional data.lastNamestring \| nulloptional data.firstNamestring \| nulloptional data.lastNameKanastring \| nulloptional data.firstNameKanastring \| nulloptional data.birthdaystring \| nulloptional data.genderinteger \| nulloptional data.branchServiceIdsarrayoptional data.branchServiceExternalIdsarrayoptional data.deletedstring \| 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 max items	-
bulk dry run	-
sync type	-
sync max limit	-
reconciliation	-

cURL

curl -X PUT "https://api.anshin.care/api/integrations/v1/companies/{company_id}/customers/{customer_id}" \
  -H "Authorization: Bearer $ANSHIN_INTEGRATION_ACCESS_TOKEN" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "externalId": 123,
  "type": 123,
  "lastName": "サンプル",
  "firstName": "サンプル",
  "lastNameKana": "サンプル",
  "firstNameKana": "サンプル",
  "birthday": "2026-07-21",
  "gender": 123,
  "notes": "string",
  "phoneNumbers": [
    {
      "id": 123,
      "phone_number": "03-0000-0000",
      "label": "string",
      "limit_on": "string",
      "certificate": "string",
      "certificate_date": "string"
    }
  ]
}'

Endpoint

field	value
method	PUT
path	/api/integrations/v1/companies/{company_id}/customers/{customer_id}
operationId	update_customer_for_integration
auth	server to server integration client token
Idempotency-Key	required
lifecycle	stable
resource type	customer
data classification	confidential
scope risk	medium
write operation	yes

Summary

対象を更新します

Required scope

scope	requirement
customers:write	required

Operation contract

field	value
bulk mode	-
bulk max items	-
bulk dry run	-
sync type	-
sync max limit	-
reconciliation	-

Path parameters

name	required	schema
company_id	required	integer
customer_id	required	integer

Query parameters

name	required	schema
-	-	-
-	-	-

Header parameters

name	required	schema
Idempotency-Key	required	string

Request body

status	media type	schema
-	application/json	IntegrationCustomerUpdateRequest

Response

status	media type	schema
200	application/json	SuccessResponse_IntegrationCustomerDetail_

Example

curl -X PUT "https://api.anshin.care/api/integrations/v1/companies/{company_id}/customers/{customer_id}" \
  -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 層で共通化します。