开放平台 API 概览

开放平台 API 让脚本或第三方系统以你本人的身份管理 RouteAPI 账户：查询余额、创建和管理 API Key、查看账户日志（支持 CSV / JSONL 导出）与用量统计。

Base URL: https://www.routeapi.ai/api/open/v1
认证方式: Authorization: Bearer rat_xxxx，创建与保管管理密钥见开放平台 API 认证

请求示例

curl https://www.routeapi.ai/api/open/v1/balance \
  -H "Authorization: Bearer $ROUTEAPI_MANAGEMENT_KEY"

/api/open/v1 下的所有接口都使用同一个请求头。响应统一为 { success, message, data } 结构；该结构、错误码与频率限制见错误与限制。

金额字段均为站点展示币种下的金额，保留两位小数（如 10.00），币种由查询余额返回。每个金额独立四舍五入，因此汇总金额与逐行明细金额相加可能有 ±0.01 的差异。

列表类接口使用统一的页码分页：

参数	类型	默认值	说明
`p`	integer	`1`	页码，取值 1–1000000
`page_size`	integer	`10`	每页条数，取值 1–1000

显式传入的 p / page_size 必须落在上述范围内，非整数、0、负数或超出范围都返回 400 invalid_request，不会自动取默认值或被截断。响应中的 page / page_size 为实际生效的值。

日志类接口的 total 最多统计到 10000，超过时 total 恒为 10000；需要完整数据请按时间范围分段拉取。

query string 中不能出现未编码的分号 ;，请编码为 %3B，否则整个请求返回 400 invalid_request。% 请编码为 %25，空格请使用 + 或 %20。

以下路径均相对于 https://www.routeapi.ai/api/open/v1。

方法	路径	说明
GET	`/balance`	查询余额

方法	路径	说明
GET	`/logs`	查询账户日志
GET	`/logs/export`	导出日志