API 参考

打开完整端点参考。参考按 API 领域分组，提供 operationId、参数、请求体、响应、鉴权和权限元数据，共享模型在数据模型页定义。可下载下方匹配版本的机器可读契约，用于生成自己的客户端。

• 下载面板 OpenAPI
• 下载节点 OpenAPI

每个生成页面记录契约 SHA-256，用于确认参考与发布构建一致。契约标识符和原始描述不做机器翻译；两种语言有相同端点结构。

调用约定复制标题链接

金额使用最小货币单位，流量使用字节；二者在 JSON 中为整数字符串。时间使用带时区时间戳。错误为 application/problem+json，含注册 code 与 request id；5xx 仅公开 common.internal_error，不要依赖内部异常消息。

写操作按端点契约提供 Idempotency-Key、If-Match、权限与再验证；同一幂等键不能用于不同请求体。认证、节点和支付回调有不同鉴权方式。不要在本公开静态参考中输入生产 token；使用受保护的 API 工具进行调试。