公開の基底 URL はありません。呼び出しはこの下書きを出すホストを使います。このパネルを開いてもトークンは作りません。

セッションは imma_session クッキーかセッションの Bearer です。エージェントトークンは顧客と在庫の書き込みで拒否されます。健全性確認にセッションは不要です。

組織はセッションから来ます。クライアントが送った組織IDは無視されます。

書き込むクッキーセッションはヘッダー x-imma-request に 1 を付けます。Bearer は使いません。GET は不要です。

顧客の GET は customers.read が必要です。POST は customers.write が必要です。在庫の POST は inventory.adjust が必要で、所有者と管理だけが持ちます。書庫はセッションが必要です。エージェント能力はエージェントトークンが必要で、範囲だけを返します。

POST /api/v1/inventory は同じ idempotencyKey と同じ内容なら棚卸を繰り返します。別内容で再利用すると 409 です。顧客作成に冪等キーはありません。

復旧は住所ごとに1時間3件までで、存在は伝えません。エージェント作業はそのトークンで1時間30件で止まります。他のマウントされた経路に HTTP 制限はありません。

マウントされた経路はコールバックを登録も受信もしません。署名検査はサーバー領域にあり、このボタンはそれを開きません。

サービストークンの発行と失効は認証済みの所有者または管理者が必要で、その組織の中に留まります。このヘッダーはトークンを発行も表示も失効もしません。回転は未実装です。

POST /api/v1/agent/jobs は jobs.write を持つエージェントトークン向けにマウントされています。例の bearer は合成で、本物の鍵ではありません。このパネルはトークンを作りません。

• GET /api/health · データベースを確認します。セッションなし。接続文字列なし。
• GET /api/v1/health · データベースと無効フラグを確認します。セッションなし。
• GET /api/v1/openapi · 機械向け文書です。不完全です。上の欠落を見てください。
• GET /api/v1/customers · セッション組織の顧客を列挙します。
• POST /api/v1/customers · 顧客を作ります。項目は code と name です。本体の organizationId は無視されます。
• POST /api/v1/inventory · 棚卸調整です。項目は warehouseId、productId、countedQty、date、idempotencyKey です。下の例は合成です。
• GET /api/v1/library/search · 照会 q。オフラインの書庫。運用される法令ではありません。
• GET /api/v1/library/citation · 照会 q と任意の locale。引用がなければエラーコードです。
• GET /api/v1/library/coverage · 範囲の件数です。法的な承認ではありません。
• GET /api/v1/agent/capabilities · 呼び出したエージェントトークンの範囲を返します。トークンは作りません。
• GET /api/v1/agent/jobs · jobs.write を持つエージェントトークンでローカル作業を入れます。上限は1時間30件です。セッショントークンは拒否されます。
• POST /api/v1/agent/jobs · jobs.write を持つエージェントトークンでローカル作業を入れます。上限は1時間30件です。セッショントークンは拒否されます。

合成の例です。本物の資格情報ではありません。

SYNTHETIC
Authorization: Bearer imma_sess_EXAMPLE
x-imma-request: 1
{"code":"C-EXAMPLE","name":"Example","organizationId":"ignored"}
{"warehouseId":"00000000-0000-0000-0000-000000000000","productId":"00000000-0000-0000-0000-000000000000","countedQty":"1","date":"2026-11-08","idempotencyKey":"example-count-1"}