跳到主要内容

API返回码速查

API以JSON格式返回,返回信息是由如下的参数组成的对象对应的JSON数据:

参数名称是否必须含义
ret_code是0:执行成功 1:全部执行失败 2:部分执行成功,部分执行失败 3:系统认证失败或者系统内部错误。
ret_msg是如果API执行成功,返回结果数据或成功提示信息;如果执行失败,返回具体的错误提示信息
error_code否如果API执行失败,来标识具体的错误代码。请参考100-199的系统错误定义

error_code详细定义:
100-199 系统错误

状态码解释
100系统错误,请稍后再试
101DSP ID,Token或者IP验证失败
102业务处理的过程中发生错误,可能是参数错误,或者是传入的信息不合法之类的,请具体参考每个API的ret_msg说明

ret_msg中出现的错误码的详细定义:

err_code错误描述
200DSP没有权限操作该广告主
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不支持的格式
604Flv素材获取不到时长信息
605URL对应的素材发生了变化,请换一个URL
606执行插入过程中发生了错误,请关注是否是同时上传
609素材URL为空或者是地址不合法
610目标地址为空或者是地址不合法
611必须指定广告主
612第三方曝光监测地址错误
613素材过大,超过素材的大小限制
614传入的file_info格式错误,无法解析成数组
615URL对应的广告主发生变化,不能上传
616同一次请求中,一个素材URL出现了多次
617限制素材上传个数
618第三方曝光监测地址不在白名单里
619第三方曝光监测数目超出限制
620DSP侧的素材ID为空或含有不合法字符或长度超过了64
625该DSP不支持投放社交化广告
626sns_type参数不合法
627社交化广告的文件格式不支持,只支持gif和jpg
628素材尺寸不支持社交化广告
629素材上传个数达到最大日上限
630file_vid含有不合法字符或长度超过了255
631display_id不合法
632monitor_position不合法
633monitor_position的个数与monitor_url的个数不一致
634DSP侧的素材ID不允许修改
635同一个DSP侧的素材ID下的文件有一些参数的值不相等
636file_text参数不合法
637DSP侧的素材ID在传入file_text参数的情况下必须也同时传入
638在多素材的情况下,由于同一个DSP侧的素材ID下的其他的文件有错误,此文件跳过处理
639在多素材的情况下,同一个DSP侧的素材ID下的文件个数超过了允许的最大个数
640传入的order_info格式错误,无法解析成数组
641同一次请求中,一个dsp_order_id出现了多次
642无音频
643该广告主不允许上传曝光监测点
644第三方点击监测地址错误
645第三方点击监测数目超出限制
646第三方点击监测地址不在白名单里
647flv素材尺寸比例错误
648flv素材播放时长错误
649ott素材仅支持flv格式
650ott素材大小限制16:9&&width>1920
651ott素材只支持上传一个flv文件,
652display_id设置无效
653display_id和素材不匹配
654display_id和素材不匹配,微动图
655display_id和素材不匹配,新闪屏
656order接口返回的素材没有通用素材
657新闪屏中视频时长不符合规格1-5s
658文件地址长度超过数据库字段长度1000
659目标地址长度超过数据库字段长度1000
700广告位不存在
801结束时间大于开始时间
802超过开始和结束时间限制
803开始和结束时间不能跨年
900用户不存在
901更新数组为空
902用户名称重复
903dsp帐号只允许改密码
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不开放
1120monitor_url监测地址,url解析异常
1121monitor_url监测地址,采用了HTTPS监测
1122monitor_url监测地址,域名有误
1123monitor_url监测地址,非腾讯媒体
1124monitor_url监测地址,宏参数有问题
1125monitor_url监测地址,内部接口调用失败
1126广告创意ad_ext.evokeapp.app_name超长 >255
1127广告创意ad_ext.evokeapp.pkg_name超长 >255
1128广告创意ad_ext.evokeapp.deep_link超长 >1000
11295分钟内有完全重复的相同内容请求调用接口
1130不支持阿里unidesk监测代码
1131音频不符合规范 声音标准(ebu r.128-2011标准)
1132monitor_settle_bill的个数与monitor_url的个数不一致(PDB指定deal_id时)
1133monitor_settle_bill 必须指定并且只能指定一条(PDB指定deal_id时)
1134可见曝光监测地址错误
1201未找到排期计划
1202deal信息配置失败
1301广告位未开放
1302未找到广告位信息