利用者の負担割合情報を取得するAPI
指定した月時点で有効な負担割合情報を取得するAPIです。
指定値がない場合はリクエスト時の当月で検索し、有効な負担割合情報を取得します。
API ID
I0005
Request URL
co-pay/select
| 環境 | URL |
|---|---|
| Staging環境 | https://stage-api.link.carekarte.jp/co-pay/select |
| 環境 | URL |
|---|---|
| 本番環境 | https://api.link.carekarte.jp/co-pay/select |
HTTPメソッド
POST
リクエスト
ヘッダー
| 名前 | 必須 | 値 |
| Content-Type | ○ | application/json |
| authorization | ○ | tokenサービスで取得した値を設定 |
ボディ
| パラメータ名 | 物理パラメータ | 型 | 必須 | 文字桁数 | 文字種/形式 | 仕様 |
| 対象利用者ID | userId | String | ○ | 10 | ||
| 月指定 | selectMonth | String | YYYY-MM | 指定した月時点で有効な負担割合情報を取得します。 値がない場合はリクエストした月で有効な負担割合情報を取得します。 |
サンプルデータ
{
"userId": "0000000004",
"selectMonth": "2022-08"
}
レスポンス
ボディ
| パラメータ名 | 物理パラメータ | 配列内パラメータ | 型 | 必須 | 文字桁数 | 文字種/形式 | 仕様 |
| 利用者ID | userId | String | ○ | 10 | |||
| 名前 | userName | String | ○ | ||||
| 名前フリガナ (半角カナ) | kanaName | String | ○ | ||||
| 対象月 | selectMonth | String | ○ | YYYY-MM | |||
| 負担割合情報 | co-payData | [array] | リクエスト月に有効な負担割合情報が存在しない場合は省略されます | ||||
| 負担割合交付日 | issueDate | String | YYYY-MM-DD | ||||
| 被保険者番号 | insuredNumber | String | 10 | ||||
| 保険者番号 | isurerNumber | String | 6 | ||||
| 保険者名称 | isurerName | String | |||||
| 負担割合期間開始日 | sdate | String | YYYY-MM-DD | ||||
| 負担割合期間終了日 | edate | String | YYYY-MM-DD | ||||
| 負担割合 | rate | String | 文字列「1割負担」「2割負担」「3割負担」いずれかで返却されます |
有効な負担割合証の取得に成功した際のサンプルデータ
{
"userId": "0000000004",
"userName": "利用者4",
"kanaName": "リヨウシャアアエ",
"selectMonth": "2022-08",
"co-payData": [
{
"issueDate": "2020-01-01",
"insuredNumber": "1111111114",
"isurerNumber": "221028",
"isurerName": "静岡市駿河区",
"sdate": "2022-07-01",
"edate": "2022-08-15",
"rate": "2割負担"
},
{
"issueDate": "2020-01-01",
"insuredNumber": "1111111114",
"isurerNumber": "221028",
"isurerName": "静岡市駿河区",
"sdate": "2022-08-16",
"edate": "2022-09-30",
"rate": "1割負担"
}
]
}
エラーレスポンス
エラーレスポンスを参照してください。
連携イメージ(CAREKARTE)

イメージ画像はCAREKARTEでの負担割合証を確認できる画面です。
サンプルリクエストの通り、有効月内で負担割合証履歴をまたぐ場合は有効月の情報として複数取得します。