没有公开的基址。调用使用正在提供此草稿的主机。打开此面板不会创建令牌。

会话是 imma_session cookie，或会话 Bearer。座席令牌在写入客户或库存时会被拒绝。健康检查不需要会话。

组织来自会话。客户端发送的组织标识会被忽略。

使用 cookie 会话进行写入时必须发送值为 1 的 x-imma-request 头。Bearer 会话不用该头。GET 不需要。

客户 GET 需要 customers.read。POST 需要 customers.write。库存 POST 需要 inventory.adjust，只有所有者和管理者持有。文库需要会话。座席能力需要座席令牌，并且只返回范围。

POST /api/v1/inventory 在相同 idempotencyKey 和相同内容时重复盘点。同一键配不同内容返回 409。创建客户没有幂等键。

恢复对每个地址每小时接受 3 次请求，并且不说明地址是否存在。座席作业对该令牌每小时停在 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 的座席令牌排队一个本地作业。配额为每小时 30 个。会话令牌会被拒绝。
• POST /api/v1/agent/jobs · 为带 jobs.write 的座席令牌排队一个本地作业。配额为每小时 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"}