[CSD003] FTO Pro charges
请求仅允许随机 UUID v4 invocation_id，最多 1 KiB。拒绝未知字段、重复键和尾随 JSON。响应仅包含受理标识与时间，服务受理成功不代表已扣费。每个明确路径由网关独立配置费率。 配置可信网关租户头；名称与平台契约对齐，外部调用方不得覆盖。
请求参数
此 API 接口支持的参数列表
| 名称 | 类型 | 示例 | 描述 |
|---|---|---|---|
必填 | string<uuid> | 584e4ed5-eab2-4a74-9bc9-6d2d7c8fbd7a | 随机 UUID v4，不得编码本地业务信息。 |
响应结构
API 响应数据的结构说明
| 字段名 | 类型 | 示例 | 描述 |
|---|---|---|---|
data | object | {
"agent_id": "novelty-search",
"trace_id": "c5507a33-03a0-4b30-a439-0b04d4c74e55",
"history_id": "6e83b730-fdce-4a21-ae28-a78696a014d5",
"accepted_at": "2026-10-23T00:00:00Z",
"invocation_id": "584e4ed5-eab2-4a74-9bc9-6d2d7c8fbd7a"
} | 接口业务数据 |
status | boolean | true | 请求是否成功 |
error_msg | string | Invalid request parameters. | 错误说明；成功时为空字符串，字段示例展示失败场景。 |
error_code | integer<int32> | - | 业务错误码，成功为 0 |
error_params | object | {} | 错误参数 |
成功响应示例
成功调用 API 的响应示例
JSON
{
"data": {
"agent_id": "novelty-search",
"trace_id": "c5507a33-03a0-4b30-a439-0b04d4c74e55",
"history_id": "6e83b730-fdce-4a21-ae28-a78696a014d5",
"accepted_at": "2026-10-23T00:00:00Z",
"invocation_id": "584e4ed5-eab2-4a74-9bc9-6d2d7c8fbd7a"
},
"status": true,
"error_msg": "请求参数不合法",
"error_code": 0,
"error_params": {}
}错误码
此接口可能返回的错误码列表
业务错误码
| 错误码 | 描述 |
|---|---|
68300004 | 请求参数异常! |
68300005 | 查询Api失败! |
68300006 | 解析基本存取错误! |
68300007 | 存在错误的请求! |
68300008 | 服务中断异常，请稍后再试! |
68300010 | 文件不符合上传规范! |
平台错误码
| 错误码 | 描述 |
|---|---|
67200001 | API整体限流错误! |
67200002 | 用户调用请求限流限制错误! |
67200003 | 申请token的key和secret不正确或者状态错误! |
67200004 | 无权限或该接口的套餐已超过系统设置的上限! |
67200005 | 账户余额不足，调用失败! |
67200006 | 客户端已过期，调用失败! |
67200007 | 超过调用额度，调用失败! |
HTTP 状态码
| 状态码 | 描述 |
|---|---|
0 | 请求成功 |
400 | 40001: JSON 非法或超限；40002: invocation_id 非法或未知字段 |
404 | 40401: Agent 未注册或未启用 |
415 | 41501: Content-Type 必须为 application/json |
503 | 50301: 记录保存失败；50302: 可信租户上下文不可用 |
500 | 50001: 未预期服务异常 |
性能指标
此接口的预期性能特征
正常响应时间
5000 ms
最大响应时间
10000 ms