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