文档目录

目录

全局返回码说明

DM Hub开放接口每次调用，可能返回正确的数据，也可能返回错误信息。所有接口返回的HTTP状态码均为200。对于错误返回，错误信息存放在返回体的error字段内，有如下结构：

{
    "error": {
        "code": "错误码",
        "message": "错误信息具体描述",
        "fieldErrors": [{
          "fieldName": "birthday",
          "message": "date format is wrong, it should be yyyy-MM-dd"
        }],
        "failedItems": [
           {}
        ]
    }
}

错误返回说明:

字段名字段说明
code错误码，全局错误码见下表，API特定错误码见API文档章节
message错误信息具体描述
fieldErrors可选字段，非批量API可以将具体的错误字段信息放在该字段返回
failedItems可选字段，批量请求API可以把发生错误的请求条目放在该字段返回

错误码列表

以下是全局通用错误码，具体接口的特别错误码请参见接口定义。

错误码说明
400000通用客户端错误
400001数据格式有误
400002访问的资源不存在
400003存在相同主键的资源
400004无法更新、删除资源
400005必填字段缺失
400006请求体中字段的类型与系统定义不同
400007数据更新发生了乐观锁
400008接口未授权
400009无权访问该资源，应用未配置相应权限，或接口不存在
400010接口授权失败
400012URL参数缺失或不满足要求
400013API请求超过调用次数
400015URL或者请求方法不存在

代码示例