错误码说明
概述
本文档列出所有 API 接口的错误码，供开发参考。
请求 ID
所有接口都支持 RequestID 机制：
- 每个请求自动生成唯一的 RequestID
- RequestID 用于日志追踪和问题排查
- RequestID 会返回在响应中
- 日志中会记录 RequestID 便于排查问题
RequestID 格式
a1b2c3d4e5f6...（32 位十六进制）
响应示例
{
"Code": 200,
"Type": "Success",
"Message": "Success",
"RequestID": "550e8400-e29b-41d4-a716-446655440000"
}
通用错误码
| 错误码 | 说明 |
|---|---|
| 10001 | 请求数据格式错误 |
| 10002 | 缺少必要参数 |
| 10003 | 参数长度错误 |
认证错误码
| 错误码 | 说明 |
|---|---|
| 20001 | AppKey/Secret 无效或过期 |
| 30001 | Token 验证失败 |
设备错误码
| 错误码 | 说明 |
|---|---|
| 40001 | 设备注册失败 |
| 40003 | 设备不存在 |
| 41001 | BuildID 已存在 |
| 41002 | BuildID 不存在 |
| 41003 | 缺少必要参数 |
| 41004 | 未找到指定网关的设备 |
系统错误码
| 错误码 | 说明 |
|---|---|
| 50001 | 服务器内部错误 |
| 50002 | 数据库错误 |