事業所のベッド情報を取得するAPI
以下の条件に合致する入所スケジュールがあった場合は、空床・使用中関わらず全てのベッド情報を返却します。
返却する情報は差分ではなく、全てのベッド情報となります。
・「終了日時が現在日時以降」かつ「リクエストパラメータのlastDataTime以降に更新された」
・「リクエストパラメータのlastDataTime」と「現在日時」の間にベッドの利用を開始している。
該当の入所スケジュールが無い場合はHTTPコード304を返却します。
・アクセスが集中する時間帯や事業所が多い法人でリクエストする場合、タイムアウトが発生する可能性があります。
・ベッド情報のマスタのみ取得したい場合は、MST0003 部屋マスタ取得APIをご使用ください。
・使用中のベッド情報のみ取得したい場合は、SC0007 入所スケジュール取得APIをご使用ください。
※上記の仕様のため、事業所稼働前（まだCAREKARTEにスケジュールが登録されていない状況）に本APIを使用して
組織情報を取得することはできません。
その場合は以下のAPIをご検討ください。
API ID
R0004
Request URL
bed/get2
| 環境 | URL |
|---|---|
| Staging環境 | https://stage-api.link.carekarte.jp/bed/get2 |
| 環境 | URL |
|---|---|
| 本番環境 | https://api.link.carekarte.jp/bed/get2 |
HTTPメソッド
POST
リクエスト
header（すべて必須）
| 名前 | 値 |
| Content-Type | application/json |
| authorization | tokenサービスで取得した値を設定 |
Body（JSON形式）
| パラメータ | 型 | 必須 | サイズ・形式 | 説明 | 仕様 |
CAREKARTEタイトル項目 |
| lastDataTime | String | ○ | YYYY-MM-DDTHH:mm:ss.sssZ | 現在保持しているデータの更新日時を渡す。 |
サンプルデータ
{
"lastDataTime": "2021-04-07T05:00:00.000Z"
}
レスポンス
Body（JSON形式）
| パラメータ | 型 | 必須 | サイズ・形式 | 説明 | 仕様 |
| status | Number | ○ | 処理結果を返却 | ||
| lastDataTime | String | YYYY-MM-DDTHH:mm:ss.sssZ | 更新日時(UTC) | ||
| result | Array | 取得データ | API KEYに紐づく事業所のベッド情報を配列で返却する | ||
| officeCd | String | 2桁 | 事業所コード | ||
| blockCd | String | 2桁 | ブロックコード | ||
| unitCd | String | 3桁 | ユニットコード | ||
| unitNm | String | ユニット名称 | |||
| roomCd | String | 3桁(※) | 部屋コード | ||
| roomNm | String | 部屋名 | |||
| bedCd | String | 3桁(※) | ベッドコード | ||
| userNm | String | 40byte | 利用者名 | ||
| userId | String | 10桁 | 利用者ID |
※居室マスタでの入力制限は3桁ではありませんが、他CAREKARTE内機能にて3桁で管理されているため、実状3桁で運用されています。
サンプルデータ
記録の取得完了
{
"status": 0,
"lastDataTime": "2021-10-03T05:24:47.421Z",
"result": [
{
"officeCd": "01",
"blockCd": "01",
"unitCd": "001",
"unitNm": "特養ユニット1-1",
"roomCd": "001",
"roomNm": "睦月",
"bedCd": "001",
"userNm": "利用者006",
"userId": "0000000022"
},
{
"officeCd": "01",
"blockCd": "01",
"unitCd": "001",
"unitNm": "特養ユニット1-1",
"roomCd": "002",
"roomNm": "如月",
"bedCd": "001",
"userNm": "",
"userId": ""
},
{
"officeCd": "01",
"blockCd": "01",
"unitCd": "001",
"unitNm": "特養ユニット1-1",
"roomCd": "003",
"roomNm": "弥生",
"bedCd": "001",
"userNm": "リンク確認1",
"userId": "0000000068"
},
{
"officeCd": "01",
"blockCd": "01",
"unitCd": "001",
"unitNm": "特養ユニット1-1",
"roomCd": "004",
"roomNm": "卯月",
"bedCd": "001",
"userNm": "利用者007",
"userId": "0000000023"
},
{
"officeCd": "01",
"blockCd": "01",
"unitCd": "001",
"unitNm": "特養ユニット1-1",
"roomCd": "005",
"roomNm": "皐月",
"bedCd": "001",
"userNm": "利用者008",
"userId": "0000000024"
},
{
"officeCd": "01",
"blockCd": "01",
"unitCd": "001",
"unitNm": "特養ユニット1-1",
"roomCd": "006",
"roomNm": "水無月",
"bedCd": "001",
"userNm": "利用者009",
"userId": "0000000025"
},
{
"officeCd": "01",
"blockCd": "01",
"unitCd": "001",
"unitNm": "特養ユニット1-1",
"roomCd": "007",
"roomNm": "文月",
"bedCd": "001",
"userNm": "",
"userId": ""
},
{
"officeCd": "01",
"blockCd": "01",
"unitCd": "001",
"unitNm": "特養ユニット1-1",
"roomCd": "008",
"roomNm": "葉月",
"bedCd": "001",
"userNm": "",
"userId": ""
},
{
"officeCd": "01",
"blockCd": "01",
"unitCd": "001",
"unitNm": "特養ユニット1-1",
"roomCd": "009",
"roomNm": "長月",
"bedCd": "001",
"userNm": "",
"userId": ""
},
{
"officeCd": "01",
"blockCd": "01",
"unitCd": "001",
"unitNm": "特養ユニット1-1",
"roomCd": "010",
"roomNm": "神無月",
"bedCd": "001",
"userNm": "",
"userId": ""
},
{
"officeCd": "01",
"blockCd": "01",
"unitCd": "001",
"unitNm": "特養ユニット1-1",
"roomCd": "011",
"roomNm": "霜月（多床室）",
"bedCd": "001",
"userNm": "",
"userId": ""
},
{
"officeCd": "01",
"blockCd": "01",
"unitCd": "001",
"unitNm": "特養ユニット1-1",
"roomCd": "011",
"roomNm": "霜月（多床室）",
"bedCd": "002",
"userNm": "",
"userId": ""
},
{
"officeCd": "01",
"blockCd": "01",
"unitCd": "001",
"unitNm": "特養ユニット1-1",
"roomCd": "011",
"roomNm": "霜月（多床室）",
"bedCd": "003",
"userNm": "",
"userId": ""
},
{
"officeCd": "01",
"blockCd": "01",
"unitCd": "001",
"unitNm": "特養ユニット1-1",
"roomCd": "011",
"roomNm": "霜月（多床室）",
"bedCd": "004",
"userNm": "",
"userId": ""
},
{
"officeCd": "01",
"blockCd": "01",
"unitCd": "001",
"unitNm": "特養ユニット1-1",
"roomCd": "012",
"roomNm": "師走（多床室）",
"bedCd": "001",
"userNm": "",
"userId": ""
},
{
"officeCd": "01",
"blockCd": "01",
"unitCd": "001",
"unitNm": "特養ユニット1-1",
"roomCd": "012",
"roomNm": "師走（多床室）",
"bedCd": "002",
"userNm": "",
"userId": ""
},
{
"officeCd": "01",
"blockCd": "01",
"unitCd": "001",
"unitNm": "特養ユニット1-1",
"roomCd": "012",
"roomNm": "師走（多床室）",
"bedCd": "003",
"userNm": "",
"userId": ""
},
{
"officeCd": "01",
"blockCd": "01",
"unitCd": "001",
"unitNm": "特養ユニット1-1",
"roomCd": "012",
"roomNm": "師走（多床室）",
"bedCd": "004",
"userNm": "",
"userId": ""
},
{
"officeCd": "01",
"blockCd": "01",
"unitCd": "002",
"unitNm": "特養ユニット1-2",
"roomCd": "001",
"roomNm": "卯月",
"bedCd": "001",
"userNm": "利用者010",
"userId": "0000000026"
},
{
"officeCd": "01",
"blockCd": "01",
"unitCd": "002",
"unitNm": "特養ユニット1-2",
"roomCd": "002",
"roomNm": "皐月",
"bedCd": "001",
"userNm": "",
"userId": ""
},
{
"officeCd": "01",
"blockCd": "01",
"unitCd": "002",
"unitNm": "特養ユニット1-2",
"roomCd": "003",
"roomNm": "水無月",
"bedCd": "001",
"userNm": "",
"userId": ""
},
{
"officeCd": "01",
"blockCd": "02",
"unitCd": "001",
"unitNm": "特養ユニット2-1",
"roomCd": "001",
"roomNm": "文月",
"bedCd": "001",
"userNm": "利用者007",
"userId": "0000000023"
},
{
"officeCd": "01",
"blockCd": "02",
"unitCd": "001",
"unitNm": "特養ユニット2-1",
"roomCd": "001",
"roomNm": "文月",
"bedCd": "002",
"userNm": "リンク確認1",
"userId": "0000000068"
},
{
"officeCd": "01",
"blockCd": "02",
"unitCd": "001",
"unitNm": "特養ユニット2-1",
"roomCd": "001",
"roomNm": "文月",
"bedCd": "003",
"userNm": "",
"userId": ""
},
{
"officeCd": "01",
"blockCd": "02",
"unitCd": "001",
"unitNm": "特養ユニット2-1",
"roomCd": "002",
"roomNm": "葉月",
"bedCd": "001",
"userNm": "",
"userId": ""
},
{
"officeCd": "01",
"blockCd": "02",
"unitCd": "001",
"unitNm": "特養ユニット2-1",
"roomCd": "002",
"roomNm": "葉月",
"bedCd": "002",
"userNm": "",
"userId": ""
},
{
"officeCd": "01",
"blockCd": "02",
"unitCd": "001",
"unitNm": "特養ユニット2-1",
"roomCd": "002",
"roomNm": "葉月",
"bedCd": "003",
"userNm": "",
"userId": ""
},
{
"officeCd": "01",
"blockCd": "02",
"unitCd": "001",
"unitNm": "特養ユニット2-1",
"roomCd": "003",
"roomNm": "長月",
"bedCd": "",
"userNm": "",
"userId": ""
},
{
"officeCd": "01",
"blockCd": "02",
"unitCd": "002",
"unitNm": "特養ユニット2-2",
"roomCd": "001",
"roomNm": "神無月",
"bedCd": "001",
"userNm": "",
"userId": ""
},
{
"officeCd": "01",
"blockCd": "02",
"unitCd": "002",
"unitNm": "特養ユニット2-2",
"roomCd": "001",
"roomNm": "神無月",
"bedCd": "002",
"userNm": "",
"userId": ""
},
{
"officeCd": "01",
"blockCd": "02",
"unitCd": "002",
"unitNm": "特養ユニット2-2",
"roomCd": "002",
"roomNm": "霜月",
"bedCd": "",
"userNm": "",
"userId": ""
},
{
"officeCd": "01",
"blockCd": "02",
"unitCd": "002",
"unitNm": "特養ユニット2-2",
"roomCd": "004",
"roomNm": "ベッド無テスト",
"bedCd": "",
"userNm": "",
"userId": ""
},
{
"officeCd": "01",
"blockCd": "91",
"unitCd": "001",
"unitNm": "外泊",
"roomCd": "001",
"roomNm": "外泊",
"bedCd": "001",
"userNm": "",
"userId": ""
},
{
"officeCd": "01",
"blockCd": "91",
"unitCd": "001",
"unitNm": "外泊",
"roomCd": "001",
"roomNm": "外泊",
"bedCd": "002",
"userNm": "",
"userId": ""
},
{
"officeCd": "01",
"blockCd": "91",
"unitCd": "001",
"unitNm": "外泊",
"roomCd": "001",
"roomNm": "外泊",
"bedCd": "003",
"userNm": "",
"userId": ""
},
{
"officeCd": "01",
"blockCd": "91",
"unitCd": "001",
"unitNm": "外泊",
"roomCd": "001",
"roomNm": "外泊",
"bedCd": "004",
"userNm": "",
"userId": ""
},
{
"officeCd": "01",
"blockCd": "91",
"unitCd": "001",
"unitNm": "外泊",
"roomCd": "001",
"roomNm": "外泊",
"bedCd": "005",
"userNm": "",
"userId": ""
},
{
"officeCd": "01",
"blockCd": "91",
"unitCd": "002",
"unitNm": "入院",
"roomCd": "001",
"roomNm": "入院",
"bedCd": "",
"userNm": "",
"userId": ""
}
]
}
API個別エラー
| HTTPコード | message | エラー説明 |
| 400 | メッセージ無し | レコードが見つかりませんでした。 |
| 400 | “Validation failed: lastDataTime must be a ISOString” | 日付の形式を修正してください。 |
{
"code": 400,
"timestamp": "10/3/2021, 5:26:51 AM",
"path": "/bed/get2",
"method": "POST",
"message": "Validation failed: lastDataTime must be a ISOString"
}
連携イメージ(CAREKARTE)
