API返回码速查
API以JSON格式返回,返回信息是由如下的参数组成的对象对应的JSON数据:
| 参数名称 | 是否必须 | 含义 |
|---|---|---|
| ret_code | 是 | 0:执行成功 1:全部执行失败 2:部分执行成功,部分执行失败 3:系统认证失败或者系统内部错误。 |
| ret_msg | 是 | 如果API执行成功,返回结果数据或成功提示信息;如果执行失败,返回具体的错误提示信息 |
| error_code | 否 | 如果API执行失败,来标识具体的错误代码。请参考100-199的系统错误定义 |
error_code详细定义:
100-199 系统错误
| 状态码 | 解释 |
|---|---|
| 100 | 系统错误,请稍后再试 |
| 101 | DSP ID,Token或者IP验证失败 |
| 102 | 业务处理的过程中发生错误,可能是参数错误,或者是传入的信息不合法之类的,请具体参考每个API的ret_msg说明 |
ret_msg中出现的错误码的详细定义:
| err_code | 错误描述 |
|---|---|
| 200 | DSP没有权限操作该广告主 |
| 300 | 必须的参数没有传入 |
| 301 | 至少必须传入此组参数中的一个 |
| 302 | 参数必须为整数 |
| 303 | 参数格式错误 |
| 304 | 参数不在允许的值的范围内 |
| 305 | 参数不是正数 |
| 306 | 参数不是合法的URL |
| 307 | 参数太长,超出了允许的长度范围 |
| 308 | 参数不是合法的YYYY-MM-DD的日期 |
| 309 | 参数不是合法的JSON数据,无法被解析 |
| 310 | 可以被解析但是是空的JSON数据 |
| 311 | 参数太短,小于允许的长度范围 |
| 312 | 可以被解析的JSON数据,但不是API要求的JSON格式 |
| 313 | 参数不是0或正数 |
| 314 | 参数的值太大,超过了允许的最大值 |
| 315 | 参数的值不允许被修改 |
| 316 | 页面暂时不开放 |
| 400 | 广告主ID不存在/没有匹配的广告主信息 |
| 500 | 广告主名称重复 |
| 501 | 广告主ID不存在 |
| 502 | 广告主不能被删除 |
| 503 | 广告主不能被修改 |
| 504 | 广告主行业不合法 |
| 505 | 广告主URL为空或者是URL不合法 |
| 506 | 广告主vocation_code不合法 |
| 507 | 广告主area为空 |
| 508 | 广告主qualification_class不合法 |
| 510 | 广告主qualification_files不合法 |
| 511 | 广告主file_name不合法 |
| 512 | 广告主file_url不合法 |
| 513 | 不支持的广告主资质文件的格式,目前支持的文件格式:jpg,jpeg,gif,png |
| 515 | 广告主name为空 |
| 516 | 广告主MEMO为空 |
| 517 | 广告主同步API在一天内相同的广告主资质信息重复调用,5分钟内不允许重复提交完全相同的广告主资质信息内容 |
| 518 | 品牌gpb不需要自己上传广告主 |
| 519 | 广告主还未通过审核 |
| 529 | 广告主投放资质不可修改 |
| 601 | 文件加载失败 |
| 602 | 未知的文件格式 |
| 603 | 不支持的格式 |
| 604 | Flv素材获取不到时长信息 |
| 605 | URL对应的素材发生了变化,请换一个URL |
| 606 | 执行插入过程中发生了错误,请关注是否是同时上传 |
| 609 | 素材URL为空或者是地址不合法 |
| 610 | 目标地址为空或者是地址不合法 |
| 611 | 必须指定广告主 |
| 612 | 第三方曝光监测地址错误 |
| 613 | 素材过大,超过素材的大小限制 |
| 614 | 传入的file_info格式错误,无法解析成数组 |
| 615 | URL对应的广告主发生变化,不能上传 |
| 616 | 同一次请求中,一个素材URL出现了多次 |
| 617 | 限制素材上传个数 |
| 618 | 第三方曝光监测地址不在白名单里 |
| 619 | 第三方曝光监测数目超出限制 |
| 620 | DSP侧的素材ID为空或含有不合法字符或长度超过了64 |
| 625 | 该DSP不支持投放社交化广告 |
| 626 | sns_type参数不合法 |
| 627 | 社交化广告的文件格式不支持,只支持gif和jpg |
| 628 | 素材尺寸不支持社交化广告 |
| 629 | 素材上传个数达到最大日上限 |
| 630 | file_vid含有不合法字符或长度超过了255 |
| 631 | display_id不合法 |
| 632 | monitor_position不合法 |
| 633 | monitor_position的个数与monitor_url的个数不一致 |
| 634 | DSP侧的素材ID不允许修改 |
| 635 | 同一个DSP侧的素材ID下的文件有一些参数的值不相等 |
| 636 | file_text参数不合法 |
| 637 | DSP侧的素材ID在传入file_text参数的情况下必须也同时传入 |
| 638 | 在多素材的情况下,由于同一个DSP侧的素材ID下的其他的文件有错误,此文件跳过处理 |
| 639 | 在多素材的情况下,同一个DSP侧的素材ID下的文件个数超过了允许的最大个数 |
| 640 | 传入的order_info格式错误,无法解析成数组 |
| 641 | 同一次请求中,一个dsp_order_id出现了多次 |
| 642 | 无音频 |
| 643 | 该广告主不允许上传曝光监测点 |
| 644 | 第三方点击监测地址错误 |
| 645 | 第三方点击监测数目超出限制 |
| 646 | 第三方点击监测地址不在白名单里 |
| 647 | flv素材尺寸比例错误 |
| 648 | flv素材播放时长错误 |
| 649 | ott素材仅支持flv格式 |
| 650 | ott素材大小限制16:9&&width>1920 |
| 651 | ott素材只支持上传一个flv文件, |
| 652 | display_id设置无效 |
| 653 | display_id和素材不匹配 |
| 654 | display_id和素材不匹配,微动图 |
| 655 | display_id和素材不匹配,新闪屏 |
| 656 | order接口返回的素材没有通用素材 |
| 657 | 新闪屏中视频时长不符合规格1-5s |
| 658 | 文件地址长度超过数据库字段长度1000 |
| 659 | 目标地址长度超过数据库字段长度1000 |
| 700 | 广告位不存在 |
| 801 | 结束时间大于开始时间 |
| 802 | 超过开始和结束时间限制 |
| 803 | 开始和结束时间不能跨年 |
| 900 | 用户不存在 |
| 901 | 更新数组为空 |
| 902 | 用户名称重复 |
| 903 | dsp帐号只允许改密码 |
| 904 | 达到最大账号数 |
| 1101 | 广告创意(dsp_order_id)已存在 |
| 1102 | 广告创意(dsp_order_id)不存在 |
| 1103 | 广告创意修改-广告形式id不能被修改 |
| 1104 | 广告创意修改-广告形式id不存在 |
| 1105 | 广告创意ad_content必填 |
| 1106 | 广告创意ad_content必须是数组 |
| 1107 | 广告创意ad_content必填字段 |
| 1108 | 广告创意ad_content.file_text为空 |
| 1109 | 广告创意ad_content.file_url为空 |
| 1110 | 广告创意ad_content.file_text超长>255 |
| 1111 | 广告创意ad_content.file_url超长>1000 |
| 1112 | 广告创意ad_content.file_url不合法 |
| 1113 | 广告创意ad_content.file_md5必须是32位md5值 |
| 1114 | 广告创意ad_content.file_md5未找到该广告主在系统中匹配项创意,请先上传一个文件,再使用该字段。 |
| 1115 | 广告创意ad_content内容和display_id不匹配。注意关于文件扩展名不匹配的错误提示,不能直接修改文件扩展名,需要文件实际格式和定义匹配 |
| 1116 | 广告形式微动图特殊处理失败wdt10711-news_client_msg5-新闻广告主端-信息流GIF-外链 |
| 1117 | 广告形式新闪屏特殊处理失败xsp11267-App_News_Splash |
| 1118 | 没有数据 |
| 1119 | 广告创意修改-广告形式id不开放 |
| 1120 | monitor_url监测地址,url解析异常 |
| 1121 | monitor_url监测地址,采用了HTTPS监测 |
| 1122 | monitor_url监测地址,域名有误 |
| 1123 | monitor_url监测地址,非腾讯媒体 |
| 1124 | monitor_url监测地址,宏参数有问题 |
| 1125 | monitor_url监测地址,内部接口调用失败 |
| 1126 | 广告创意ad_ext.evokeapp.app_name超长 >255 |
| 1127 | 广告创意ad_ext.evokeapp.pkg_name超长 >255 |
| 1128 | 广告创意ad_ext.evokeapp.deep_link超长 >1000 |
| 1129 | 5分钟内有完全重复的相同内容请求调用接口 |
| 1130 | 不支持阿里unidesk监测代码 |
| 1131 | 音频不符合规范 声音标准(ebu r.128-2011标准) |
| 1132 | monitor_settle_bill的个数与monitor_url的个数不一致(PDB指定deal_id时) |
| 1133 | monitor_settle_bill 必须指定并且只能指定一条(PDB指定deal_id时) |
| 1134 | 可见曝光监测地址错误 |
| 1201 | 未找到排期计划 |
| 1202 | deal信息配置失败 |
| 1301 | 广告位未开放 |
| 1302 | 未找到广告位信息 |