跳到主要内容

API 返回码速查

一 返回结构​

所有 API 以 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 R128-2011）
1132monitor_settle_bill 的个数与 monitor_url 的个数不一致（PDB 指定 deal_id 时）
1133monitor_settle_bill 必须指定并且只能指定一条（PDB 指定 deal_id 时）
1134可见曝光监测地址错误
1201未找到排期计划
1202deal 信息配置失败
1301广告位未开放
1302未找到广告位信息