【公開停止】お知らせ(個人)情報登録API(デフォルト記録対応版)

お知らせ(個人)の記録を登録するAPI
※この記録を作成することで連絡ノートへ自動転記されます
※通所系サービスの標準です(連絡ノート)

API ID

CN0001

Request URL

communication/prinote-add-d
環境 URL
Staging環境 https://stage-api.link.carekarte.jp/communication/prinote-add-d
環境 URL
本番環境 https://api.link.carekarte.jp/communication/prinote-add-d

HTTPメソッド

POST

リクエスト

header(すべて必須)

名前
Content-Type application/json
authorization tokenサービスで取得した値を設定

Body(JSON形式)

パラメータ 必須:○
条件付き:△(※)
サイズ・形式 説明 仕様 CAREKARTEタイトル項目
userId String 10桁 利用者ID    
sdateTime String YYYY-MM-DD HH:mm:ss
または
YYYY-MM-DDTHH:mm:ss.sssZ
記録開始日時 YYYY-MM-DD HH:mm:ssで連携:JSTとしてそのままの時間で記録を作成
YYYY-MM-DDTHH:mm:ss.sssZで連携:UTCとみなし、YYYY-MM-DDTHH:mm:ss.sss+09:00の時間で記録を作成
 
edateTime String   YYYY-MM-DD HH:mm:ss
または
YYYY-MM-DDTHH:mm:ss.sssZ
記録終了日時 連携なし またはsdateTimeより過去の日時の場合、sdateTimeの時間をセット
YYYY-MM-DD HH:mm:ssで連携:JSTとしてそのままの時間で記録を作成
YYYY-MM-DDTHH:mm:ss.sssZで連携:UTCとみなし、YYYY-MM-DDTHH:mm:ss.sss+09:00の時間で記録を作成
 
defaultFlag Boolean     デフォルト記録フラグ true:デフォルト記録読み込みあり
falseまたはパラメータなし:デフォルト記録読み込みなし
 
handoverFlag Boolean     申し送りフラグ true:申し送り記録
falseまたはパラメータなし:通常記録
 
privatenotice String   お知らせ   連絡事項
staffId String 10桁 職員ID    

※必須項目欄の入力項目△については、△部分が全て空の値の場合、記録を作成せず400エラーを返却する。空欄部分の入力有無は、記録の作成に影響しない。

サンプルデータ

{
    "userId": "0000000013",
    "sdateTime":"2022-02-08T03:01:02.000Z",
    "edateTime":"2022-02-08 13:03:04",
    "defaultFlag":false,
    "handoverFlag":false,
    "privatenotice":"個人のお知らせ直接入力",
    "staffId":"2200000036"
}

レスポンス

Body(JSON形式)

パラメータ 必須 サイズ・形式 説明 仕様
userId String 10桁 利用者ID  
recordId Number[array]     記録ID  
message String     メッセージ エラー等、メッセージがあれば返却

サンプルデータ

記録の登録完了
{
    "userId": "0000000013",
    "recordId": [
        1349
    ]
}

エラー発生時(存在しない利用者IDの場合)
{
    "code": 400,
    "timestamp": "2/10/2022, 6:42:52 AM",
    "path": "/communication/prinote-add-d",
    "method": "POST",
    "message": "UserId does not exist"
}

連携イメージ(CAREKARTE)