利用者の介護保険情報を取得するAPI
CAREKARTEに登録されている利用者の介護保険情報を取得するAPIです。
利用者IDを使用して利用者を特定し、指定した日付時点での有効な介護保険情報を取得可能です。
値がない場合はリクエストした日付で有効な介護保険情報を取得します。
API ID
I0001
Request URL
insurance/id-select
| 環境 | URL |
|---|---|
| Staging環境 | https://stage-api.link.carekarte.jp/insurance/id-select |
| 環境 | URL |
|---|---|
| 本番環境 | https://api.link.carekarte.jp/insurance/id-select |
HTTPメソッド
POST
リクエスト
header(すべて必須)
| 名前 | 値 |
| Content-Type | application/json |
| authorization | tokenサービスで取得した値を設定 |
Body(JSON形式)
| パラメータ | 型 | 必須:○ | サイズ・形式 | 説明 | 仕様 |
| userId | String | ○ | 10桁 | 利用者ID | |
| date | String | YYYY-MM-DD hh:mm:ss | 日付指定 | 指定した日付時点で有効な介護保険情報を取得する 値がない場合はリクエストした時点で有効な介護保険情報を取得する |
サンプルデータ
{
"userId": "0000001721",
"date": "2021-10-03"
}
レスポンス
Body(JSON形式)
| パラメータ | 型 | 必須 | サイズ・形式 | 説明 | 仕様 |
| userId | String | ○ | 10桁 | 利用者ID | |
| insuredNumber | String | ○ | 10桁 | 被保険者番号 | |
| insuredClass | String | ○ | 1桁 | 被保険者区分 | 0:空白 1:第1号被保険者 2:第2号被保険者 9:その他 |
| userName | String | ○ | 名前 | CAREKARTEの「基本情報管理>基本情報」の氏名 | |
| kanaName | String | ○ | 名前フリガナ (半角カナ) | CAREKARTEの「基本情報管理>基本情報」のフリガナ | |
| deliveryDate | String | YYYY-MM-DD | 交付年月日 | ||
| provisionalFlag | Boolean | 暫定フラグ | true:暫定保険者証 false:通常 |
||
| isurerNumber | String | ○ | 保険者番号 | ||
| isurerName | String | ○ | 保険者名称 | ||
| careLevel | String | ○ | 2桁 | 要介護度 | 00:空白 01:非該当 11:要支援 (経過的要介護) 12:要支援1 13:要支援2 21:要介護1 22:要介護2 23:要介護3 24:要介護4 25:要介護5 31:再調査 88:取消 99:なし |
| certificationDate | String | YYYY-MM-DD | 認定年月日 | ||
| certificationSdate | String | ○ | YYYY-MM-DD | 認定有効期間開始日 | |
| certificationEdate | String | ○ | YYYY-MM-DD | 認定有効期間終了日 | |
| limitCost | String | 区分支給限度基準額 (1月あたり) |
|||
| limitCostSdate | String | YYYY-MM-DD | 区分支給限度基準額有効期間開始日 | ||
| limitCostEdate | String | YYYY-MM-DD | 区分支給限度基準額有効期間終了日 | ||
| limitCostOfType | [array] | 種類支給限度基準額 | |||
| serviceName | String | 種類支給限度基準額のサービス名称 | |||
| cost | String | サービスごとの種類支給限度基準額 | |||
| benefitRestrictions | [array] | 給付制限 | 最大内容数は3 | ||
| content | String | 給付制限内容 | |||
| sdate | String | YYYY-MM-DD | 給付制限期間開始日 | ||
| edate | String | YYYY-MM-DD | 給付制限期間終了日 | ||
| supportOfficeNumber | String | 居宅介護支援事業所番号 | |||
| supportOfficeName | String | 居宅介護支援事業所名称 | |||
| notificationDate | String | YYYY-MM-DD | 届出年月日 | ||
| selfCreated | Boolean | 自己作成フラグ | true:自己作成 false:自己作成でない |
||
| opinion | String | 審査委員会意見 サービス種類指定 |
サンプルデータ
正常取得時
{
"userId": "0000001721",
"insuredNumber": "1000001011",
"insuredClass": "1",
"userName": "青椿あい",
"kanaName": "アオツバキアイ",
"deliveryDate": "2021-06-01",
"provisionalFlag": true,
"isurerNumber": "452094",
"isurerName": "えびの市",
"careLevel": "22",
"certificationDate": "2021-06-02",
"certificationSdate": "2021-06-03",
"certificationEdate": "2025-06-04",
"limitCost": "1000",
"limitCostSdate": "2025-06-05",
"limitCostEdate": "2025-06-06",
"limitCostOfType": [
{
"serviceName": "訪問介護",
"cost": "2000"
},
{
"serviceName": "訪問看護",
"cost": "3000"
}
],
"benefitRestrictions": [
{
"content": "4000",
"sdate": "2021-06-07",
"edate": "2021-06-08"
},
{
"content": "5000",
"sdate": "2021-06-09",
"edate": "2021-06-10"
}
],
"supportOfficeNumber": "0000002020",
"supportOfficeName": "居宅介護支援事業所名称",
"notificationDate": "2021-06-11",
"selfCreated": true,
"opinion": "審査委員会意見サービス種類指定"
}
API個別エラー
| HTTPコード | message | エラー説明 |
| 400 | “UserId does not exist” | 利用者IDが見つかりませんでした。 |
| 400 | “Data does not exist” | 有効な介護保険情報が見つかりませんでした。 |
| 400 | “Validation failed: userId must be a string” | 利用者IDの形式を修正してください。 |
| 400 | “Validation failed: date is incorrect format YYYY-MM-DD” | 日時の形式を修正してください。 |
{
"code": 400,
"timestamp": "10/3/2021, 4:08:37 AM",
"path": "/insurance/id-select",
"method": "POST",
"message": "UserId does not exist"
}
連携イメージ(CAREKARTE)
