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 未找到广告位信息