中心温度 API

中心温度 （ app=coreThermo ）の点検結果を扱う API の仕様です。
共通の認証・ベースURLは 基本情報・認証仕様 を参照してください。

1. 🗺️ エンドポイント一覧

⚠️ 非対応スコープ（制限事項）
以下の操作およびデータ連携には対応していません。

• 送信後の修正、データの削除
• 確認・承認フローの実行
• 特記事項（コメント）の登録
• 本部点検票の紐づけ設定
• 点検画像のアップロード
• NG 時のメール通知
• 帳票マスタ（点検票・グループ・点検項目）の取得・更新
• スケジュール完了の登録

2. 📥 POST: 点検結果の登録

登録リクエストは、複数件の一括処理（バッチ処理）を考慮し、 常に data 配列で統一 します。
1件のみ登録する場合であっても、要素数が1の配列として送信してください。
点検項目は checkItems 配列で送信します。保存・GET では画面と同じ contents キーになります。

2.1 リクエストデータ構造

2.2 tags[]（グループ情報）の構造

画面のグループ情報と同じく、保存時は uid / label / type / content のみです。 chipSelect の複数選択は content を配列で送ると "A,B" の文字列に結合します。

2.3 checkItems[]（点検項目）の構造

入力タイプと checkResult の対応

2.4 リクエストJSONサンプル

{
  "data": [
    {
      "sheetName": "加熱後中心温度",
      "sender": "山田太郎",
      "tags": [
        {
          "label": "商品名",
          "type": "text",
          "content": "唐揚げ"
        }
      ],
      "checkItems": [
        {
          "content": "中心温度",
          "type": "number",
          "checkResult": 75.5,
          "required": true,
          "unit": "℃",
          "min": 75,
          "max": ""
        },
        {
          "content": "外観",
          "type": "okng",
          "checkResult": "OK",
          "required": true
        }
      ]
    }
  ]
}

2.5 入力バリデーションルール

1. 基本構造の不備 : リクエスト JSON 全体に data 配列が存在しない、または空配列である。
2. 必須項目の欠落 : sheetName / sender が未指定または空文字、 checkItems が配列でない、または空配列である。
3. 必須点検項目の未入力 : required: true の項目で checkResult が空の場合は登録不可。
4. 入力タイプの不正 : 点検項目・グループの type が許可値以外。
5. 数値範囲設定の不整合 : type: "number" で min と max の両方を指定する場合、 min <= max である必要があります。

💡 点検結果が NG になる場合について
type: "okng" かつ checkResult が "NG" 、または数値が min / max の範囲外の場合、登録される点検結果は NG（異常あり） 扱いになります。 データの登録自体は成功します。 1件でも NG 判定の項目があれば、そのレコード全体が NG 扱いになります。

2.6 POST レスポンス仕様

HTTPステータスコードは全体成功を示す 200 、一部成功を示す 207 Multi-Status 、全件失敗を示す 400 を返却します。

{
  "status": "success",
  "shopUID": "xxxxxxxxxxxxxxxxxxxx",
  "summary": {
    "requested": 1,
    "created": 1,
    "failed": 0
  },
  "results": [
    {
      "index": 0,
      "status": "success",
      "docId": "core_thermo_doc_id_11111"
    }
  ]
}

3. 📤 GET: 点検結果の取得

取得系APIにおいて、レスポンスに含まれるすべての日付・時刻フィールドは、 YYYY/MM/DD HH:mm の文字列形式に統一されて返却されます。

3.1 単一取得（docId 指定）

• Request: GET {baseUrl}?app=coreThermo&docId=core_thermo_doc_id_11111

{
  "data": [
    {
      "id": "core_thermo_doc_id_11111",
      "userUID": "API_COMMON_USER",
      "shopUID": "xxxxxxxxxxxxxxxxxxxx",
      "groupUID": "core_thermo_doc_id_11111",
      "sheetName": "加熱後中心温度",
      "sender": "山田太郎",
      "tags": [
        {
          "uid": "",
          "label": "商品名",
          "type": "text",
          "content": "唐揚げ"
        }
      ],
      "contents": [
        {
          "uid": "",
          "content": "中心温度",
          "type": "number",
          "referable": false,
          "required": true,
          "checkResult": 75.5,
          "isShowMinus": false,
          "unit": "℃",
          "digit": 5,
          "decimalDigit": 2,
          "min": 75,
          "max": ""
        },
        {
          "uid": "",
          "content": "外観",
          "type": "okng",
          "referable": false,
          "required": true,
          "checkResult": "OK"
        }
      ],
      "isNormalForReport": true,
      "registeredAt": "2026/08/20 00:00",
      "sentAt": "2026/08/20 09:16",
      "confirmedAt": "",
      "confirmerName": "",
      "approvedAt": "",
      "approverName": "",
      "createdAt": "2026/08/20 09:16",
      "updatedAt": "2026/08/20 09:16"
    }
  ]
}

3.2 一覧取得（date 指定）

• GET {baseUrl}?app=coreThermo&date=2026-08（月次一覧取得）
• GET {baseUrl}?app=coreThermo&date=2026-08-20（日次一覧取得）

💡 サーバー側での自動フィルタリング・ソート規則

• 認証されたAPIキーに紐づく shopUID のデータのみに自動制限されます。
• データは 営業日順（registeredAt の昇順） 、同じ営業日内においては 帳票名順（sheetName の昇順） でソートして返却されます。

3.3 🗂️ 点検結果オブジェクト詳細定義（GETレスポンス）