外部連携（WebAPI）

AI Agent チートシート

人が仕様を読みながらコードを書く代わりに、チートシートを AI Agent に読み込ませ、「やりたいこと」を尋ねてコードを書いてもらうための節です。下の契約（チートシート）はコピーしてエージェントに渡せます。

使い方（ステップ）

1. 下のアコーディオンを開き、コピーでチートシート全文を取得する
2. 使っている AI Agent の会話・ルール・プロンプトに貼り付けて読み込ませる（キー文字列は含めない）
3. やりたいことを自然文で伝える（例: 「今日の現場 ASM のライブ OEE を取る Python を書いて」／「実績をバッチ登録するスクリプトを」）
4. エージェントが書いたコードを確認し、必要なら修正を依頼する
5. 実行前に認証の渡し方を決める（次項）。キーの値をチャットに貼らない

# DELTA WebAPI — Agent cheat sheet (safe use)

Base (production): https://delta.956.jp/api/v1
Auth: Authorization: Bearer <api key>
  Prefer reading from environment variable DELTA_WEBAPI_KEY (or the host secret store).
  Embedding the key in local/private code is allowed if the human chooses; never commit or share that value.
  Never ask the user to paste the key into chat. Never print, log, or commit the key value.
Content-Type: application/json
Times: ISO8601 with offset (e.g. 2026-08-24T09:00:00+09:00)
Ids: prefer workplace/work/worker/sku *codes* from DELTA masters; responses may include public_id (UUID).

## Hard rules (do not violate)
- Call ONLY DELTA host endpoints under /api/v1 (not the partner MES/BI host).
- Scope is the organization of the API key. Never attempt cross-tenant access.
- Do not invent paths, fields, or event names. If unsure, stop and ask a human.
- Writes: always send Idempotency-Key and a stable external_id when available.
- defect_quantity must be <= actual_quantity.
- pause creates NonProduction kind=other; resume closes it; humans may reclassify later.
- Do NOT use API for: browser login, kiosk/staff QR sessions, daily-report planned stops as job pause, changing OEE formulas.
- Prefer least privilege: read-only key for dashboards; write key only when registering records/instructions.
- If no key is available (env unset and not otherwise provided privately), stop and ask the human how they want to supply it (do not invent a key).
- Never echo the key in curl -v, debug dumps, screenshots, chat, or commit messages.

## Read (取得系)
GET /workplaces?code=&active=all|true|false&include_streams=true|false
GET /work_masters?workplace_id={code_or_id}&code=&active=all|true|false
GET /workers?retired=false|true|all&code=&active=all|true|false
GET /skus?code=&active=all|true|false
GET /work_record_items?work_date_from=YYYY-MM-DD&work_date_to=YYYY-MM-DD&work_record_status=draft|confirmed|all
GET /work_record_items/{id}
GET /work_instructions?status=open|cancelled|consumed|all&workplace_id={code_or_id}
GET /workplaces/{code_or_id}/oee/live?window=shift_today|day|last_1h
GET /oee?from=YYYY-MM-DD&to=YYYY-MM-DD&group_by=workplace|work_master|worker
GET /non_productions?from=ISO&to=ISO&status=open|closed|all
GET /workplaces/{code_or_id}/non_productions?from=ISO&to=ISO&status=open|closed|all

## Write (登録系)
POST /workplaces | PATCH /workplaces/{code_or_id}  (scope write:masters)
POST /work_masters | PATCH /work_masters/{code_or_id}  (workplace_code required on create)
POST /workers (pin required) | PATCH /workers/{code_or_id}
POST /skus | PATCH /skus/{code_or_id}
POST /work_record_items/batch
  body.items[]: external_id, workplace_code, worker_code, work_master_code, sku_code?,
    planned_quantity, actual_quantity, defect_quantity, started_at, ended_at,
    standard_cycle_time_sec?, non_productions[]?, instruction_no?
  options: on_missing_master=error, wrap_up=true|false

POST /work_instructions
  body: instruction_no, sku_code, work_master_code, workplace_code, planned_quantity, due_date?, external_id?

POST /work_instructions/{id}/events
  body.event: start|pause|resume|qty_update|stop|wrap_up
  body: at?, worker_code?, workplace_code?, actual_quantity?, defect_quantity?, note?, non_productions[]?
  Typical flow: start → (qty_update|pause/resume)* → stop → wrap_up

## Real Time OEE
POST /oee/streams/ticks  (scope write:oee_streams)
  Cumulative snapshot: workplace/line/equipment (any one+), at, run_time_sec (operating),
  stop_time_sec?, total_count, defect_count, ideal_cycle_time_sec?
GET /oee/streams/live?workplace=&line=&equipment=&window=30m&points=48  (scope read:oee_streams)
GET /oee/streams/live/stream?...  (SSE; same params)
  Embed: /widget/rt-oee.js with data-workplace/line/equipment/window/target/token
GET /workplaces/{code_or_id}/oee/live/stream?window=...  (scope read:oee; SSE)

## Webhooks (管理)
GET/POST /webhooks | GET/PATCH/DELETE /webhooks/{id}  (scope write:webhooks)
POST /webhooks/{id}/test | /rotate_secret | /disable | /enable
Incoming events: HTTPS POST to your URL, header X-Delta-Signature (admin UI or API above).

## When blocked
- Missing master codes → create masters in DELTA admin first (or report error; do not invent).
- Duplicate start on same instruction → conflict; do not retry start blindly.
- Endpoint not listed above → treat as unavailable; do not guess.

Status: read and write endpoints published. OpenAPI: GET /api/v1/openapi.json (no auth).
Webhooks: /api/v1/webhooks (scope write:webhooks) or admin UI /admin/webhooks (HTTPS push, X-Delta-Signature).
SSE live: GET .../oee/live/stream (read:oee), GET /oee/streams/live/stream (read:oee_streams).

キーを見せない・渡さない

チートシートとエージェントへの依頼には使い方だけを入れ、管理画面で発行したキー文字列そのものは入れません。チャット・ログ・コミット・スクリーンショットにも貼らないでください。

実行時の渡し方は、エージェント案でもユーザー判断でも構いません。例:

• 環境変数 … 名前は DELTA_WEBAPI_KEY（ハイフン不可）。シェルや実行環境のシークレットに値を置き、コードはそれを読んで Authorization: Bearer … に使う
• プログラムへの埋め込み … 試作や閉じた環境向け。リポジトリや共有先にキーが乗らないよう注意する

未設定や権限不足なら、エージェントはキー値を推測せず止まって、人に設定を促すのが安全です。

やりたいこと一覧

やりたいことを選び、下の節で呼び出し方まで確認してください。

接続の基本

どの「やりたいこと」でも共通です。先にここを決めてから、個別の呼び出しに進みます。

接続先

呼び先はDELTA 側のホストです（連携先の MES／BI などのホストではありません）。

https://delta.956.jp/api/v1

検証環境など別ホストで DELTA を動かしている場合は、その DELTA のホストに読み替えてください。

OpenAPI

エージェントやクライアント生成向けに、公開済みエンドポイントの機械可読な契約を配信しています（認証不要）。

GET /api/v1/openapi.json

人間向けの説明はこのページ、実装メモは開発用 docs/web_api_dev.md を参照してください。

認証

管理者が発行した API キーを、すべてのリクエストに付けます。キーは組織に紐づき、他組織のデータには届きません。発行・失効は管理画面の APIキー から行います。

Authorization: Bearer dk_live_xxxxx

1. 管理画面の APIキー でキーを発行し、権限（read:oee / write:records など）を付ける
2. 外部システム側の設定にキーを保存する（ソースコードに直書きしない）
3. 漏洩・退職・システム廃止のときはキーを失効する

書込みの再送

実績や指示の登録では、同じ内容を二度送っても二重登録しないよう、Idempotency-Key（推奨）と、外部側の行 ID（external_id）を使います。

Idempotency-Key: mes-batch-20260824-001

時刻・コード

• 時刻は ISO8601（例: 2026-08-24T09:00:00+09:00）
• 現場・作業・作業員・SKU は、管理画面で登録したコードで指定できる
• 応答では public_id（UUID）も返す想定（以降の参照に使える）

いまの現場 OEE を見る 提供中

こんなときに … 行灯・大型モニタ・BI に「この現場のいま」を出したい。

呼び出し

GET /api/v1/workplaces/{現場のIDまたはコード}/oee/live
    ?window=shift_today
GET /api/v1/workplaces/{現場のIDまたはコード}/oee/live/stream
    ?window=shift_today

window の例: shift_today（今日のシフト） / day（当日） / last_1h（直近1時間）。/stream は Server-Sent Events（変更時のみ event: live で push）。

期間の OEE を取る 提供中

こんなときに … 「先週の現場別」「今月の作業員別」をレポートや他 DB に取り込みたい。

呼び出し

GET /api/v1/oee
    ?from=2026-08-01
    &to=2026-08-23
    &group_by=workplace

group_by: workplace（現場） / work_master（作業） / worker（作業員）

絞り込み（任意）: workplace_id / work_master_id / worker_id / org_unit_id / capture_mode

停止を一括で取る 提供中

こんなときに … 他システム側にダッシュボードがあり、「いま／今日、DELTA で何が止まっているか」を一覧で取り込みたい。組織全体でも、特定現場だけでも取れます。

呼び出し

# 組織全体（キーの組織スコープ）
GET /api/v1/non_productions
    ?from=2026-08-24T00:00:00+09:00
    &to=2026-08-24T23:59:59+09:00
    &status=open|closed|all

# 所定の現場だけ
GET /api/v1/workplaces/{現場のコードまたはID}/non_productions
    ?from=…
    &to=…
    &status=open

status の例: open（継続中の停止） / closed（終了済み） / all（両方）

マスタを同期する 提供中

こんなときに … 連携システム側で DELTA のコード表を揃えたい。実績や指示を送る前に、現場・作業・作業員・SKU の一覧を取得します。

呼び出し

GET /api/v1/workplaces
GET /api/v1/work_masters?workplace_id={現場コードまたはID}
GET /api/v1/workers
GET /api/v1/skus

権限は read:masters（取得）と write:masters（登録・更新）。ページングは page / per_page（最大 200）。code で完全一致検索、active=true|false|all で有効／無効を絞れます。

書き込み

POST /api/v1/workplaces
PATCH /api/v1/workplaces/{idまたはcode}
POST /api/v1/work_masters   (workplace_id または workplace_code 必須)
PATCH /api/v1/work_masters/{idまたはcode}
POST /api/v1/workers        (pin 必須)
PATCH /api/v1/workers/{idまたはcode}
POST /api/v1/skus
PATCH /api/v1/skus/{idまたはcode}

変更系は Idempotency-Key ヘッダーを推奨します。ストリーム専用現場は更新できません。

• 現場 … 既定は人間向け現場のみ。include_streams=true でストリーム専用現場も含む
• 作業 … workplace_id で現場を絞り込み（code 可）
• 作業員 … 既定は有効な人間作業員。retired=all で退職者も含む

実績を取る 提供中

こんなときに … MES や会計システムが、DELTA に登録された作業実績を定期的に取り込みたい。

呼び出し

GET /api/v1/work_record_items
GET /api/v1/work_record_items/{id}

権限は read:records。日付を指定しない場合は当日の work_date のみ返します。

• work_date_from / work_date_to … 日報の日付で絞り込み
• started_from / started_to … 実績の開始時刻で絞り込み（ISO8601）
• external_id … 外部システムの行 ID で 1 件検索
• work_record_status … draft / confirmed / all
• workplace_id / worker_id / work_master_id … code または数値 ID

応答には OEE スコア（DELTA ローカル正）と、詳細取得時は non_productions[] が含まれます。

未消化の指示を取る 提供中

こんなときに … スケジューラや MES が、まだ着手していない作業指示の残件を確認したい。

呼び出し

GET /api/v1/work_instructions?status=open
GET /api/v1/work_instructions?status=open&workplace_id={現場コードまたはID}

権限は read:instructions。既定は status=open（未着手）。due_date_from / due_date_to で納期を絞れます。

実績をまとめて登録する 提供中

こんなときに … MES や別システムで確定した「いつ・誰が・何を・何個」を、DELTA の作業実績に載せたい。

呼び出し

POST /api/v1/work_record_items/batch
Authorization: Bearer dk_live_xxxxx
Idempotency-Key: mes-20260824-001
Content-Type: application/json

{
  "items": [
    {
      "external_id": "MES-ROW-1001",
      "workplace_code": "ASM",
      "worker_code": "S-01",
      "work_master_code": "W-01",
      "sku_code": "SKU-001",
      "planned_quantity": 20,
      "actual_quantity": 18,
      "defect_quantity": 1,
      "started_at": "2026-08-24T09:00:00+09:00",
      "ended_at": "2026-08-24T09:45:00+09:00",
      "standard_cycle_time_sec": 120,
      "non_productions": [
        { "kind": "changeover", "duration_sec": 600, "note": "段取" }
      ]
    }
  ],
  "options": { "on_missing_master": "error", "wrap_up": true }
}

指示を登録して実行する 提供中

こんなときに … 生産スケジューラで作った指示を DELTA に渡し、開始〜終了まで同じ指示に紐づけて追いたい。現場では QR でも読ませたい。

1. 指示を登録する

POST /api/v1/work_instructions

{
  "instruction_no": "WI-2026-0042",
  "sku_code": "SKU-001",
  "work_master_code": "W-01",
  "workplace_code": "ASM",
  "planned_quantity": 100,
  "due_date": "2026-08-25",
  "external_id": "MES-WO-7788"
}

応答には指示の ID と、現場端末向け DELTA WI JSON（作業指示 QR と同じ形）が付きます。仕様の背景は 管理者向け・作業指示書 QR を参照。

2. 実行イベントを送る

POST /api/v1/work_instructions/{id}/events
Idempotency-Key: wi-42-start-1

{
  "event": "start",
  "at": "2026-08-24T10:00:00+09:00",
  "worker_code": "S-01",
  "workplace_code": "ASM"
}

一時停止を記録する 提供中

こんなときに … 設備やラインが止まったことを可動（A）に反映したい。理由の細かい分類は後で直したい。

呼び出し

# 止まる
POST /api/v1/work_instructions/{id}/events
{ "event": "pause", "at": "2026-08-24T10:20:00+09:00", "note": "api:pause" }

# 再開する
POST /api/v1/work_instructions/{id}/events
{ "event": "resume", "at": "2026-08-24T10:35:00+09:00" }

イベントを Webhook で受け取る 提供中

外部システムへ DELTA のイベントをプッシュします。受信 URL の登録は管理画面（/admin/webhooks）または API（write:webhooks）で行います。

設定場所

管理画面の 連携 → Webhook（/admin/webhooks）または GET/POST/PATCH/DELETE /api/v1/webhooks。無料枠は組織あたり 1 件。追加枠はプラン画面の Webhook 契約から購入できます。テスト送信・配信ログ・Secret の再発行ができます。

API で管理する（write:webhooks）

GET    /api/v1/webhooks
POST   /api/v1/webhooks
GET    /api/v1/webhooks/{id}
PATCH  /api/v1/webhooks/{id}
DELETE /api/v1/webhooks/{id}
POST   /api/v1/webhooks/{id}/test
POST   /api/v1/webhooks/{id}/rotate_secret
POST   /api/v1/webhooks/{id}/disable
POST   /api/v1/webhooks/{id}/enable

作成時と Secret 再発行時のみ、レスポンスに secret が含まれます。管理画面と併用できます。

イベント種別

• work_record_item.stopped … 作業停止後
• work_record_item.wrapped_up … 数量確定（wrap-up）後
• work_record.confirmed … 日報確定後
• oee.below_target … 選択した OEE 指標が目標を下回った瞬間（現場ライブ／ストリームライブ）

署名

各 POST に X-Delta-Signature: t=<unix>,v1=<hmac> が付きます（HMAC-SHA256、エンドポイントごとの Secret）。受信側は event.id で重複排除してください。順序は保証されません（at-least-once）。

{
  "id": "evt_…",
  "type": "work_record_item.wrapped_up",
  "created_at": "2026-09-02T10:05:00+09:00",
  "organization_id": 1,
  "data": { }
}

ストリームとは 提供中

DELTA 側の設定

管理画面でストリームと API キーを整え、埋め込みコードを発行するまでの手順です。

Step 01

API キーを発行する

1. 管理画面の APIキー を開く
2. 書き込み用キーを発行し、権限に write:oee_streams を付ける（外部システムのシークレットに保存）
3. 読み取り用キーを発行し、権限に read:oee_streams を付ける（Widget の data-token 用）
4. 平文キーは管理画面の一覧からコピーできます。チャットや git に貼らない

Step 02

ストリームを登録する

1. サイドメニュー 運用設定 → 連携 → ストリームを開く
2. 画面上部のストリーム枠（使用数 / 上限）を確認する。既定上限は 1 件。足りない場合は 運用コース で Stream×3 / ×5 / ×10 を契約する
3. 表示名と、キー（workplace / line / equipment）を入力する。いずれか1つ以上必須
4. 「追加する」でストリームを作成する（同時にレポート用の専用現場が紐づく）

キー文字列は、外部システムが POST する JSON の同名フィールドと完全一致させてください。未登録キーで POST すると自動作成もされますが、枠上限を超える新規キーは拒否されます。先に画面で揃えるのが安全です。レポート側での見方は上の「レポートの現場としても扱える」を参照。

Step 03

キーと受信を確認する

1. 一覧から「詳細・ティック」を開く
2. 上部のキーボードで stream_key・workplace / line / equipment・最終ティックを確認する
3. 「受信ティック」タブで POST された累積スナップショットが新しい順に並ぶことを確認する
4. 試験データが不要なら「データクリア」で範囲を選んで削除できる（復元不可）

Step 04

埋め込みコードを作る

1. 「埋め込み」タブを開く
2. テーマ（dark / light / compact 組み合わせ）、窓（30分〜3時間）、目標 OEE（%）を選ぶ
3. プレビューが約5秒ごとに更新されることを確認する（管理画面セッション経由）
4. 「埋め込みコードをコピー」で HTML を取得し、data-token を読み取り用キーに置き換える
5. 自社ページや MES の HTML に貼り付ける

Step 05

WebAPI 連携タブで契約を確認する

「WebAPI 連携」タブには、このストリーム向けの POST / GET 例が載っています。外部実装のたたき台として使えます。

<!-- DELTA R/T Widget -->
<div class="delta-rt-oee-wrap theme-dark">
  <div id="rt-oee-1"
       class="delta-rt-oee theme-dark"
       data-workplace="FIN"
       data-line="LINE-A"
       data-equipment="EQ-01"
       data-window="30m"
       data-target="0.85"
       data-token="YOUR_EMBED_TOKEN"></div>
</div>
<script src="https://delta.956.jp/widget/rt-oee.js" async></script>

外部システムでの実装

外部側は、設備カウンタや MES から得た累積値を JSON にして、定期的に（例: 5〜30 秒ごと）POST します。

POST https://delta.956.jp/api/v1/oee/streams/ticks
Authorization: Bearer <write:oee_streams のキー>
Content-Type: application/json
Idempotency-Key: mes-tick-FIN-LINE-A-20260827T163000  （推奨）

{
  "workplace": "FIN",
  "line": "LINE-A",
  "equipment": "EQ-01",
  "at": "2026-08-27T16:30:00+09:00",
  "run_time_sec": 3600,
  "stop_time_sec": 600,
  "total_count": 420,
  "defect_count": 3,
  "ideal_cycle_time_sec": 85.5
}

curl -sS -X POST "https://delta.956.jp/api/v1/oee/streams/ticks" \
  -H "Authorization: Bearer ${DELTA_WEBAPI_KEY}" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: mes-tick-$(date +%Y%m%d%H%M%S)" \
  -d '{
    "workplace": "FIN",
    "line": "LINE-A",
    "equipment": "EQ-01",
    "at": "2026-08-27T16:30:00+09:00",
    "run_time_sec": 3600,
    "stop_time_sec": 600,
    "total_count": 420,
    "defect_count": 3,
    "ideal_cycle_time_sec": 85.5
  }'

require "json"
require "net/http"
require "uri"
require "time"

uri = URI("https://delta.956.jp/api/v1/oee/streams/ticks")
body = {
  workplace: "FIN",
  line: "LINE-A",
  equipment: "EQ-01",
  at: Time.now.iso8601,
  run_time_sec: 3600,
  stop_time_sec: 600,
  total_count: 420,
  defect_count: 3,
  ideal_cycle_time_sec: 85.5
}

req = Net::HTTP::Post.new(uri)
req["Authorization"] = "Bearer #{ENV.fetch("DELTA_WEBAPI_KEY")}"
req["Content-Type"] = "application/json"
req["Idempotency-Key"] = "mes-tick-#{Time.now.strftime("%Y%m%d%H%M%S")}"
req.body = JSON.generate(body)

res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(req) }
raise "tick failed: #{res.code} #{res.body}" unless res.is_a?(Net::HTTPSuccess)
puts res.body

import json
import os
from datetime import datetime, timezone, timedelta
from urllib import request

JST = timezone(timedelta(hours=9))
payload = {
    "workplace": "FIN",
    "line": "LINE-A",
    "equipment": "EQ-01",
    "at": datetime.now(JST).isoformat(timespec="seconds"),
    "run_time_sec": 3600,
    "stop_time_sec": 600,
    "total_count": 420,
    "defect_count": 3,
    "ideal_cycle_time_sec": 85.5,
}
req = request.Request(
    "https://delta.956.jp/api/v1/oee/streams/ticks",
    data=json.dumps(payload).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {os.environ['DELTA_WEBAPI_KEY']}",
        "Content-Type": "application/json",
        "Idempotency-Key": datetime.now(JST).strftime("mes-tick-%Y%m%d%H%M%S"),
    },
    method="POST",
)
with request.urlopen(req) as res:
    print(res.read().decode("utf-8"))

const key = process.env.DELTA_WEBAPI_KEY;
if (!key) throw new Error("DELTA_WEBAPI_KEY is not set");

const at = new Date().toISOString();
const body = {
  workplace: "FIN",
  line: "LINE-A",
  equipment: "EQ-01",
  at,
  run_time_sec: 3600,
  stop_time_sec: 600,
  total_count: 420,
  defect_count: 3,
  ideal_cycle_time_sec: 85.5,
};

const res = await fetch("https://delta.956.jp/api/v1/oee/streams/ticks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${key}`,
    "Content-Type": "application/json",
    "Idempotency-Key": `mes-tick-${Date.now()}`,
  },
  body: JSON.stringify(body),
});
if (!res.ok) {
  throw new Error(`tick failed: ${res.status} ${await res.text()}`);
}
console.log(await res.json());

using System.Net.Http.Headers;
using System.Text;
using System.Text.Json;

var key = Environment.GetEnvironmentVariable("DELTA_WEBAPI_KEY")
    ?? throw new InvalidOperationException("DELTA_WEBAPI_KEY is not set");

var payload = new {
    workplace = "FIN",
    line = "LINE-A",
    equipment = "EQ-01",
    at = DateTimeOffset.Now.ToString("o"),
    run_time_sec = 3600,
    stop_time_sec = 600,
    total_count = 420,
    defect_count = 3,
    ideal_cycle_time_sec = 85.5
};

using var client = new HttpClient();
using var req = new HttpRequestMessage(
    HttpMethod.Post,
    "https://delta.956.jp/api/v1/oee/streams/ticks");
req.Headers.Authorization = new AuthenticationHeaderValue("Bearer", key);
req.Headers.TryAddWithoutValidation("Idempotency-Key", $"mes-tick-{DateTimeOffset.Now:yyyyMMddHHmmss}");
req.Content = new StringContent(
    JsonSerializer.Serialize(payload),
    Encoding.UTF8,
    "application/json");

using var res = await client.SendAsync(req);
res.EnsureSuccessStatusCode();
Console.WriteLine(await res.Content.ReadAsStringAsync());

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.OffsetDateTime;
import java.time.format.DateTimeFormatter;

String key = System.getenv("DELTA_WEBAPI_KEY");
if (key == null || key.isBlank()) throw new IllegalStateException("DELTA_WEBAPI_KEY is not set");

String at = OffsetDateTime.now().format(DateTimeFormatter.ISO_OFFSET_DATE_TIME);
String json = """
  {
    "workplace": "FIN",
    "line": "LINE-A",
    "equipment": "EQ-01",
    "at": "%s",
    "run_time_sec": 3600,
    "stop_time_sec": 600,
    "total_count": 420,
    "defect_count": 3,
    "ideal_cycle_time_sec": 85.5
  }
  """.formatted(at);

HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://delta.956.jp/api/v1/oee/streams/ticks"))
    .header("Authorization", "Bearer " + key)
    .header("Content-Type", "application/json")
    .header("Idempotency-Key", "mes-tick-" + System.currentTimeMillis())
    .POST(HttpRequest.BodyPublishers.ofString(json))
    .build();

HttpResponse<String> res = HttpClient.newHttpClient()
    .send(req, HttpResponse.BodyHandlers.ofString());
if (res.statusCode() / 100 != 2) {
  throw new IllegalStateException("tick failed: " + res.statusCode() + " " + res.body());
}
System.out.println(res.body());

GET https://delta.956.jp/api/v1/oee/streams/live
    ?workplace=FIN&line=LINE-A&equipment=EQ-01
    &window=30m&points=48
Authorization: Bearer <read:oee_streams のキー>