返回码

为了方便用户理解Marketing API调用返回的错误信息，平台将通过errors结构对关键信息进行暴露，确保所有接入客户均可通过程序化的方式，对报错进行处理。

以请求被黑白名单拒绝而返回无权限的报错信息为例：

返回示例：

{
    "code": 31033,
    "message": "This parameter is not permitted on this behavior_or_interest, the sign is intent_targeting. trace_id: a7afca14bb571095be3914645d3ec905",
    "message_cn": "您没有权限操作指定参数，参数名：behavior_or_interest，对应的白名单标识：intent_targeting，请联系您的运营经理申请此白名单权限。trace_id: a7afca14bb571095be3914645d3ec905",
    "errors": [
        {
            "type": "PRIVILEGE_PARAM_EXCEPTION",     // 代表该客户因为账户不在灰度白名单范围内而无法使用指定功能
            "description": "This parameter is not permitted on this behavior_or_interest, the sign is intent_targeting.",
            "privilege_param_exception_spec": {
                "param": "behavior_or_interest",
                "privilege_code": "intent_targeting"     //通过privilege_code暴露白名单名称，方便接入客户进行程序化处理。
            }
        }
    ]
}

其中，errors是一个数组，仅在某些有必要返回关键信息的情况下存在。 该数组具有以下关键属性：
1、type: 一定会返回，表示报错类型，不同的报错类型，具有不同的spec结构，如例子中的privilege_param_exception_spec，是针对PRIVILEGE_PARAM_EXCEPTION类型的定制spec。
2、spec: 指定情况下会返回，关键报错信息，如privilege_code是白名单标识；和type是联动关系，spec的名字为type的小写+"_spec"组成，同一种type下，返回的spec结构是一致的，如例子中的PRIVILEGE_PARAM_EXCEPTION类型，返回的spec关键信息均为param和privilege_code。
3、description：指定情况下会返回，报错信息描述。

截至到2020年4月，返回码信息如下：