API 概览

基础地址

https://kyt-api.alphatok.xyz

认证

每个请求都在 Authorization header 中携带 API 凭证：

Authorization: Bearer <app_id>.<secret>

组织管理员负责创建凭证。详见 认证。

额度与厂商限流

筛查额度与厂商限流是两件事。GATEWAY_QUOTA_BALANCE_EXHAUSTED 表示你所在组织的累计筛查额度已用尽——所有 API Key 共用这一份，没有任何时钟会把它补回来；PROVIDER_RATE_LIMITED 表示所选厂商限制了上游调用。详见 状态码。

请求 ID

每个响应都带 X-Request-Id 头，出错时同样有。就单次调用询问时请报上它：对筛查调用它定位到那条调用记录，若该次消耗了额度，这也是那笔扣减的记录 ID。在进入 API 之前就被拒的请求——路径或方法不存在——同样会返回 ID，但它背后什么也没留下。该值由 API 生成，你自己发送 X-Request-Id 不会改变返回的值。

先选厂商与能力，再选链

每次筛查请求只问一家厂商。省略 provider 时使用租户当前默认厂商；显式填写时只问指定且已启用的厂商。响应会回显实际作答方。schema 展示平台链并集，真正可选子集来自该厂商与能力的“列出能力链”端点。筛查请求在 body 里传链 slug，响应返回链 enum。详见 AML API。平台不会跨 provider 合并结论。