DOCS · API CONTRACT

API 契约

业务系统只通过稳定 HTTP 契约和中枢对话。下面的字段说明与 /schemas/api/*.schema.json 保持一致,后台和 SDK 示例都应以这组 schema 为准。

POST/run
{
  "request_id": "order-10001-ai-001",
  "route": "order_assistant",
  "input": "帮我分析这个订单为什么迟迟未发货",
  "metadata": { "tenant_id": "t_100", "operator_uid": "u_42" },
  "callback": "https://biz.example.com/ai/callback"
}
GET/jobs/{job_id}
{
  "id": "job_...",
  "status": "queued | running | done | error",
  "result": { "summary": "...", "detail": {} },
  "error": null
}
POST业务侧 callback URL
X-Bailing-Signature: sha256=<hmac>
X-Bailing-Timestamp: 1782912000

{
  "kind": "delivery",
  "job_id": "job_...",
  "route": "order_assistant",
  "status": "done",
  "result": { "summary": "..." }
}

机器可读 schema