错误码 invalid-凯发app官方网站

更新时间：2023-07-27 10:08:39

我的文档

设置

本说明涉及的接口

创建活动报名接口、查询活动报名详情接口、下线活动报名接口。

错误码 invalid_parameter 的说明

接口的业务错误码中，错误码为 invalid_parameter 的错误详情会根据调用接口的传参情况而不同，需要开发者解析 sub_msg 来理解详细错误信息。

类似如下接口调用错误样例，sub_code 为 isv.invalid_parameter

，sub_msg 字符串存在固定的格式，开发者可以按照固定格式解析出详细错误内容。

{

"alipay_marketing_campaign_recruit_enroll_create_response": {

"msg": "business failed",

"code": "40004",

"sub_code": "isv.invalid_parameter",

"sub_msg": "参数有误。请求参数不合法：[{\"errorreason\":\"缺失\",\"fieldpath\":\"enrollcontent.appitems[0].outitemid\",\"legalmsg\":\"不能为null，长度必须大于等于1且小于等于100\"}]"

}

sub_msg 的格式说明

sub_msg 的整体格式为：

"参数有误。请求参数不合法：" json 字符串

。

json 字符串的格式为：

[

{

"errorreason": "具体的异常原因",

"fieldpath": "错误的字段路径",

"legalmsg": "对该字段的合法性要求"

{

}

// ...可能有多个

]

比如上方的错误样例，sub_msg 解析出来是如下数据：

该错误的含义就是，路径为的字段 outitemid 缺失，这个字段的要求是

不能为 null，长度必须大于等于 1 且小于等于 100

。

创建活动报名接口错误码 invalid_parameter 的特殊说明

创建活动报名接口的接口传参要求是根据具体目标活动方案确定。所以，创建活动报名接口的传参校验分为了静态字段协议校验和动态字段协议校验。

静态字段协议校验

：在不考虑目标活动方案的具体要求的情况下，接口字段的最低限度要求。

动态字段协议校验

：在静态字段协议校验的基础上，根据目标活动方案的具体要求，对接口字段进一步的限制。

比如

：

不考虑目标活动方案时，创建活动报名接口传参的最低限度要求只有：

out_biz_no、enroll_base_info.plan_id、enroll_content 是必传的，其他字段如果传了，只要符合字段要求即可。

假设目标活动方案要求 enroll_content.mini_apps、enroll_material.materials 必传，那么最终必传的字段是：

out_biz_no

enroll_base_info.plan_id

enroll_content

enroll_content.mini_apps

enroll_content.mini_apps.mini_app_id

enroll_material.materials

enroll_material.materials.material_id

除上面的必传字段，其他的接口字段都不能传。

更多样例

不妨多看几个样例，可能理解起来会更简单明了。

素材的字段缺失

out_biz_no 传值长度超限

小程序商品 id 为空

相关问题