响应格式

所有 REST API 都返回 JSON。 客户端应同时读取 HTTP 状态码和响应体中的 code。

字段说明

字段	类型	必填	说明
code	string	是	业务码。成功类和错误类都使用大写下划线格式
message	string	是	人类可读说明，仅用于展示、日志和排障
requestId	string	是	请求编号，排障时需要提供
data	object	成功类响应必填	成功类响应的数据内容。失败响应不返回该字段

客户端处理规则

• 客户端必须基于 HTTP status 和 code 做程序分支
• 客户端不能基于 message 做程序分支
• message 仅用于展示、日志和排障上下文，不适合作为程序判断条件

成功类响应

下面示例仅展示统一响应外层结构。data 内的具体字段以各接口文档为准。

{
  "code": "SUCCESS",
  "message": "OK.",
  "requestId": "req_001",
  "data": {
    "example": "..."
  }
}

失败响应

{
  "code": "AUTH_INVALID",
  "message": "Authentication credentials are invalid.",
  "requestId": "req_001"
}

使用说明

• 成功响应包含 data
• 失败响应不包含 data
• COMMAND_ACCEPTED 属于成功类业务码，响应中会包含 data