対象の事業所に所属のある利用者の情報を取得するAPI
指定した日時以降更新された差分の情報を取得します。
日時をかなり過去のもの（1900年代等）で指定したり、取得する差分値が大きいと
レスポンスが遅くなるため、適度な日時をご指定ください。
API ID
U0003
Request URL
user/get2
| 環境 | URL |
|---|---|
| Staging環境 | https://stage-api.link.carekarte.jp/user/get2 |
| 環境 | URL |
|---|---|
| 本番環境 | https://api.link.carekarte.jp/user/get2 |
HTTPメソッド
POST
リクエスト
header（すべて必須）
| 名前 | 値 |
| Content-Type | application/json |
| authorization | tokenサービスで取得した値を設定 |
Body（JSON形式）
| パラメータ | 型 | 必須 | サイズ・形式 | 説明 | 仕様 |
| updateDate | String | ○ | YYYY-MM-DDTHH:mm:ss.sssZ | 更新日時(UTC) | 前回取得時の日時をセットしていただくことで、前回取得時からの更新分のみの利用者情報を取得 |
サンプルデータ
{
"updateDate": "2021-01-03T10:00:00.000Z"
}
レスポンス
Body（JSON形式）
| パラメータ | 型 | 必須 | サイズ・形式 | 説明 | 仕様 |
| status | Number | ○ | 処理結果を返却する | ||
| updateDate | String | ○ | YYYY-MM-DDTHH:mm:ss.sssZ | データ取得日時(UTC) | |
| user | [array] | 利用者情報 | |||
| userId | String | ○ | 10桁 | 利用者ID | |
| family | String | ○ | 姓 | ||
| given | String | ○ | 名 | ||
| kanafamily | String | ○ | 姓フリガナ （半角カナ） | ||
| kanagiven | String | ○ | 名フリガナ（半角カナ） | ||
| nicknm | String | ニックネーム | |||
| birth | String | ○ | yyyy/mm/dd | 生年月日 | |
| sex | Number | ○ | 1桁 | 性別 | 1：男性 2：女性 |
| postCd | String | 7桁 | 郵便番号 | ||
| tel | String | 12桁 | 電話番号 | ||
| addr | String | 住所 | 住所１+住所２ | ||
| belong | [array] | 所属 | 全事業所分 | ||
| officeCd | String | ○ | 2桁 | 事業所コード | |
| blockCd | String | 2桁 | ブロックコード | ||
| unitCd | String | 3桁 | ユニットコード | ||
| unitNm | String | ユニット名 |
サンプルデータ
正常データ取得時
{
"status": 0,
"updateDate": "2021-10-03T15:58:22.220Z",
"user": [
{
"userId": "0000000016",
"family": "利用者",
"given": "005",
"kanafamily": "ﾘﾖｳｼｬ",
"kanagiven": "ｱｵ",
"nicknm": "",
"birth": "1949/08/24",
"sex": 2,
"postCd": "",
"tel": "",
"addr": "",
"belong": [
{
"officeCd": "T1",
"blockCd": "01",
"unitCd": "001",
"unitNm": "特養ユニット1-1"
},
{
"officeCd": "11",
"blockCd": "01",
"unitCd": "001",
"unitNm": "デイサービス"
},
{
"officeCd": "21",
"blockCd": "01",
"unitCd": "001",
"unitNm": "訪問介護"
}
]
},
{
"userId": "0000000068",
"family": "リンク",
"given": "確認1",
"kanafamily": "ﾘﾝｸ",
"kanagiven": "ｶｸﾆﾝｱ",
"nicknm": "リンク",
"birth": "1936/11/05",
"sex": 1,
"postCd": "",
"tel": "",
"addr": "",
"belong": [
{
"officeCd": "03",
"blockCd": "01",
"unitCd": "001",
"unitNm": "老健ユニット1-1"
},
{
"officeCd": "11",
"blockCd": "01",
"unitCd": "001",
"unitNm": "デイサービス"
},
{
"officeCd": "T1",
"blockCd": "01",
"unitCd": "001",
"unitNm": "特養ユニット1-1"
},
{
"officeCd": "02",
"blockCd": "01",
"unitCd": "001",
"unitNm": "老健ユニット1-1"
},
{
"officeCd": "05",
"blockCd": "01",
"unitCd": "001",
"unitNm": "入居ユニット1-1"
},
{
"officeCd": "01",
"blockCd": "01",
"unitCd": "001",
"unitNm": "特養ユニット1-1"
}
]
},
{
"userId": "0000000015",
"family": "利用者",
"given": "004",
"kanafamily": "ﾘﾖｳｼｬ",
"kanagiven": "ｱｴ",
"nicknm": "",
"birth": "1952/05/06",
"sex": 1,
"postCd": "",
"tel": "",
"addr": "",
"belong": [
{
"officeCd": "T1",
"blockCd": "01",
"unitCd": "001",
"unitNm": "特養ユニット1-1"
},
{
"officeCd": "11",
"blockCd": "01",
"unitCd": "001",
"unitNm": "デイサービス"
},
{
"officeCd": "21",
"blockCd": "01",
"unitCd": "001",
"unitNm": "訪問介護"
}
]
},
{
"userId": "0000000012",
"family": "利用者",
"given": "001",
"kanafamily": "ﾘﾖｳｼｬ",
"kanagiven": "ｱｱ",
"nicknm": "",
"birth": "1960/08/03",
"sex": 2,
"postCd": "",
"tel": "0752217744",
"addr": "静岡県静岡市葵区○○１－１",
"belong": [
{
"officeCd": "T1",
"blockCd": "01",
"unitCd": "001",
"unitNm": "特養ユニット1-1"
},
{
"officeCd": "25",
"blockCd": "01",
"unitCd": "001",
"unitNm": "訪問看護"
},
{
"officeCd": "11",
"blockCd": "01",
"unitCd": "001",
"unitNm": "デイサービス"
},
{
"officeCd": "21",
"blockCd": "01",
"unitCd": "001",
"unitNm": "訪問介護"
},
{
"officeCd": "12",
"blockCd": "01",
"unitCd": "001",
"unitNm": "通所リハ"
}
]
},
{
"userId": "0000000013",
"family": "利用者",
"given": "002",
"kanafamily": "ﾘﾖｳｼｬ",
"kanagiven": "ｱｲ",
"nicknm": "",
"birth": "1950/08/02",
"sex": 1,
"postCd": "",
"tel": "",
"addr": "",
"belong": [
{
"officeCd": "T1",
"blockCd": "01",
"unitCd": "001",
"unitNm": "特養ユニット1-1"
},
{
"officeCd": "11",
"blockCd": "01",
"unitCd": "001",
"unitNm": "デイサービス"
},
{
"officeCd": "21",
"blockCd": "01",
"unitCd": "001",
"unitNm": "訪問介護"
},
{
"officeCd": "12",
"blockCd": "01",
"unitCd": "001",
"unitNm": "通所リハ"
}
]
},
{
"userId": "0000000014",
"family": "利用者",
"given": "003",
"kanafamily": "ﾘﾖｳｼｬ",
"kanagiven": "ｱｳ",
"nicknm": "",
"birth": "1955/08/24",
"sex": 2,
"postCd": "",
"tel": "",
"addr": "",
"belong": [
{
"officeCd": "T1",
"blockCd": "01",
"unitCd": "001",
"unitNm": "特養ユニット1-1"
},
{
"officeCd": "11",
"blockCd": "01",
"unitCd": "001",
"unitNm": "デイサービス"
},
{
"officeCd": "21",
"blockCd": "01",
"unitCd": "001",
"unitNm": "訪問介護"
}
]
},
{
"userId": "0000000566",
"family": "通所",
"given": "フジケア人",
"kanafamily": "ﾂｳｼｮ",
"kanagiven": "ﾌｼﾞｹｱｼﾞﾝ",
"nicknm": "",
"birth": "1936/11/11",
"sex": 1,
"postCd": "2222223",
"tel": "34353333333",
"addr": "",
"belong": [
{
"officeCd": "11",
"blockCd": "01",
"unitCd": "001",
"unitNm": "デイサービス"
}
]
}
]
}
エラー発生時
{
"code": 400,
"timestamp": "10/3/2021, 6:59:48 AM",
"path": "/user/get2",
"method": "POST",
"message": "Validation failed: Invalid updateDate"
}
連携イメージ(CAREKARTE)
