沃量系统媒体接入文档

1 请求

1.1 概述

注:字符编码统一为UTF-8 请求字段在原基础上做兼容处理,增加部分新字段。 返回结果全部重新设计 相关注意事项如下:

  1. 不要对我方的广告结果进行缓存,因为广告存在计费和用户预算等实时性要求较高的业务,请确保每次需要时再请求广告。
  2. 沃量系统推荐从用户客户终端设备直接请求广告;如果需要使用server代理用户发送广告请求,请确保传递ip参数正确设置,另外需要提前告知我方server的公网ip并确认我方已经进行配置后方可正式上线使用。
  3. 返回报文中的上报地址(clickTrackUrls和impTrackUrls)需在客户点击/看到广告时进行调用完成行为上报,请务必使用http get方式(不要使用post/head等方式)。
  4. 服务器请求需提供服务器的外网出口IP列表,因接口有限流策略,如果您通过服务器发起请求,请事先告知我方公网出口ip。
  5. 进行跨域调用需提供跨域调用的完整域名地址,考虑安全策略,如果需要进行接口跨域调用,请事先告知我方跨域调用的完整域名地址

1.2 约定

字段参数中遵循如下约定:

1.2.1 字段命名

为兼容java接口代码,字段名均统一使用驼峰命名。

1.2.2 必填说明

  1. Y : 表示字段必填,不填则不会返回数据
  2. N : 表示字段非必填,不影响数据返回
  3. R : 推荐填充,表示字段在某特定条件下必填,特定条件下会影响数据返回

2 对外接口

2.1 ads通用广告接口

该接口只支持POST方式,且接口header中需要指定Content-Type为application/json

2.1.1 接入参数说明

以下为必要字段的说明

2.1.1.1 deviceId

设备唯一标识,安卓设备请使⽤imei或imei的md5值,MD5值全大写, iOS设备请使⽤idfa明⽂(全⼤写)。

2.1.2 请求地址
环境 方法 请求地址
线上 post (http)https://s.adphoenixs.com/v1/sgAds
2.1.3 请求参数
名称 类型 是否必填 示例 描述
device Device object Y 设备相关信息
imps Imp object array Y ⼴告位请求信息,⼀个⼴告请求对应对应⼀个组⼴告信息,⾄少应该填⼀个,⽬前暂时仅⽀持⼀个⼴告请求
app App object N app信息
keyword string N 请求关键词,如果不为空,系统将根据该关键词匹配⼴告。该字段为搜索类⼴告位使⽤,如需使⽤,请联系运营⼈员
channel string N 渠道标识,是媒体针对⾃⼰不同的流量来源(例如不同的渠道包)进⾏区分的⼀个字段,沃量后续版本会在媒体的结算数据报表⾥增加按channel区分的结算数据
version string Y 版本号

2.1.3.1 Device object

名称 类型 是否必填 示例 描述
deviceId string Y 1EA55320-60C6-4B87-8D61- 5A7B8AF8D98E 设备唯⼀ID,详⻅2.1.1.1
network int Y 6 ⽤户所在的⽹络环境 2 2g,3 3g,4 4g, 5 5g,6wifi,1unknown
deviceType int Y 1 设备类型 1 ⼿机 2 平板 3 OTT终端 4 PC 9 其他。注:OTT终端包括互联⽹电视和电视机顶盒
imei string R 861916030230770或A01234567890FF 安卓设备的imei号明⽂,⻓度<=16位,数字或字符,优先取imei;如果没有,则填写meid;如果meid没有则留空。当os为android时, imei、imeiMd5作为必选字段,可以⼆选⼀。其中imei字段传输明⽂值
imeiMd5 string R ED5B86E6771370C5C172829975E684DC imei使⽤md5加密,全⼤写的字符串。当os为android时,imei、imeiMd5作为必选字段,可以⼆选⼀。其中imei字段传输明⽂值
idfa string R 9C287922-EE26-4501-94B5-DDE6F83E1475 当os为ios设备时, idfa字段为必填。 idfa明⽂为16进制32位⻓度,按8-4-4-4-12的⻓度分布
androidId string R 8F029BD7BCF2942 当os为android时,可通过此字段传输安卓id。值为16位16进制全⼤写字符串
brand string R Huawei 设备品牌。deviceType为1或2时,该字段必填,iOS系统设备请统⼀填写为Apple
model string R P7 设备型号。deviceType为1或2时,该字段必填
os string R Android 设备操作系统版本号。deviceType为1或2时,该字段必填。android系统请填android,ios系统请填ios,其它系统请按实际情况填写
osVersion string R 5.0 设备操作系统版本。deviceType为1或2时,该字段必填
carrier int R 2 设备运营商信息,1 中国移动 2 中国联通 3 中国电信 9 其他,如果有多个运营商,请传第⼀个即可。deviceType为1时,该字段必填
mac string R 设备mac标识,⼤写明⽂(保留冒号)。deviceType为1或2时,该字段必填
ip string N 请求的设备ip。设备的公⽹IP。校验规则:必须是公⽹IP,不允许传输类似10打头的内⽹ip或服务器ip
userAgent String Y 设备的客户端UA,传输设备的webview标准ua,优先使⽤userAgent,若传空,则使⽤header中的userAgent
geo Geo object N 地理位置信息
2.1.3.1.1 Geo object
名称 类型 是否必填 示例 描述
longitude double N 30.122313 经度,传递该参数可以基于⽤户位置更加精准的投放⼴告
atitude double N 45.123123 纬度,传递该参数可以基于⽤户位置更加精准的投放⼴告
2.1.3.2 Imp object
名称 类型 是否必填 示例 描述
id int Y 1 impId,从1开始计数
count int N 2 当前请求的⼴告条数,不填默认为1,最多为50。超过50修正为50;⼩于1修正为1
video Video object N 视频⼴告请求,视频⼴告请求不能为空
2.1.3.2.1 Video object
名称 类型 是否必填 示例 描述
minDuration int N 30 最⼩的视频⻓度,闭区间,包含最⼩⻓度, 以毫秒为单位,默认为0不限制
maxDuration int N 70 最⼤的视频⻓度,闭区间,包含最⼤⻓度, 以毫秒为单位,默认为0不限制
mimeTypes string N ⽀持的视频类型, 1:video/mp4, mp4格式;2:video/3gpp, 3gp格式;3:video/x-msvideo, avi格式;4:video/x-flv, flv格式;5:video/x-ms-wmv,wmv格式;6:video/quicktime, mov格式。默认为空不限制,多个请⽤英⽂逗号(,)分割
sizes Size object array N 允许的视频尺⼨
maxLength int N 允许的视频最⼤⻓度,以KB为单位,默认为0不限制
2.1.3.2.2 Size object
名称 类型 是否必填 示例 描述
width int N 允许的视频尺⼨宽度,默认为0不限制
height int N 允许的视频尺⼨⾼度,默认为0不限制
2.1.3.3 App object
名称 类型 是否必填 示例 描述
pkgName string N app应⽤包名信息
appName string N app应⽤名
category string N app类⽬名称

3 返回值

3.1 AdResponse object

名称 类型 示例 描述
code int 200 系统响应码,200为正常,其他为异常。详⻅系统响应码表
msg string 错误提示
data Data object ⼴告结果信息
3.1.1 Data object
名称 类型 示例 描述
requestId string 0000400000401524109061178 请求的requestId
ts long 1524109081892 返回⼴告时间戳
groups Group object array ⼴告组列表,所有规格⼴告列表
3.1.1.1 Group object
名称 类型 示例 描述
impId int 1 impId,对应请求中imps结构中的id
ads Ad object array 对应某种规格下的⼴告列表
3.1.1.1.1 Ads object
名称 类型 示例 描述
id int 0 ⼴告序号
creativeId long 60013468 ⼴告唯⼀ID
title string 360%E5%80%9F%E6%9D%A1 urlencode之后的标题信息
summary string 360%E5%A5%87%E8%99%8E... urlencode之后的描述信息
link string http:\/\/rd.e.sogou.com\/ck?url=... ⼴告链接地址或者是app下载地址
clickTrackUrls string array ["http://rd.e.sogou.com/nck?url=&st=49CjS9UTfm"] ⼴告链接点击后的回调地址数组,⾥⾯的地址需全部调⽤
impTrackUrls string array ["http://rd.e.sogou.com/nvw?url="] ⼴告展示后的回调地址,⾥⾯的地址需全部调⽤
adWidth double 1200.0 ⼴告位宽度
adHeight double 500.0 ⼴告位⾼度
adType int 0 表示⼴告的展示类型。1.原⽣图⽂⼴告 2.banner⼴告 3.开屏⼴告 4.插屏⼴告 5.原⽣视频⼴告 9. 其他⼴告
downloadAd int 1 表示是否是下载类⼴告。1.下载类 0.⾮下载类
source string %e6%90%9c%e7%8b%97%e5%a5%87%e7%82%b9 表示⼴告来源。urlEncode之后的字符串。⼴告主填写该字段,则填充为⼴告主填写的字段,否则为默认值"沃量",
nativeAdType int 1 nativeAd_type: 新增字段,当adType=1时,该字段有值。1.small(⼩图)2.big(⼤图)3.group(组图)9. 其他
price int 20000 ⼴告价格,单位为千分之⼀分
imgs Image object array ⼴告图⽚信息
appInfo App object 包信息,下载类⼴告才有
splashInfo Splash object 开屏⼴告信息
video Video object 视频信息
3.1.1.1.1.1 imgs object
名称 类型 示例 描述
url string http://adstream.123.sogoucdn.com/lst/pic/1502181722812.jpg ⼴告图⽚的url
width double 1200.0 图⽚宽度,如:1200
height double 500.0 图⽚⾼度,如: 500
desc string xxx urlencode之后的图⽚描述,没有留空
3.1.1.1.1.2 appInfo object
名称 类型 示例 描述
icon string 表示下载类⼴告应⽤的图标图⽚地址
pkgName string com.youai.fytxcr.sy37 Apk⼴告下载包包名
size long 61479564 包⼤⼩
md5 string d446c5c1d3ec58e191276c2469c5287e apk包MD5值
version string 1.0,1 版本名和版本号使⽤,拼接⽽成,例如1.4.0.801,60
dsUrl string http://test.rd.e.sogou/ds?url=&posid=2... 下载开始回调地址,⾮下载类⼴告该字段为空
dfUrl string http://test.rd.e.sogou/df?url=&posid=2... 下载完成回调地址,⾮下载类⼴告该字段为空
sfUrl string http://test.rd.e.sogou/sf?url=&posid=2 安装完成回调地址,⾮下载类⼴告该字段为空
deepLink string app唤醒地址,如果媒体端⽀持deeplink,且⽤户安装有对应的app,则点击时使⽤此字段调起
3.1.1.1.1.3 Splash object
名称 类型 示例 描述
countdown int 2 开屏⼴告建议倒计时时间(单位秒),⾮开屏⼴告为-1
maxPerDay int 1 开屏⼴告建议⼀天重复显示最⼤次数,⾮开屏⼴告为-1
interval int 100 开屏⼴告建议两次相同⼴告出现最⼩间隔(单位秒),⾮开屏⼴告为-1
startTime long 开屏⼴告计划开始时间,此时间前不要展示此⼴告,值为时间 戳(从1970.1.1⾄今毫秒数),⾮开屏⼴告为-1
endTime long 开屏⼴告计划结束时间,此时间后不要展示此⼴告,值为时间戳(从1970.1.1⾄今毫秒数),⾮开屏⼴告为-1
type int 1 开屏⼴告类型 1 全屏 2 半屏,⾮开屏⼴告为-1
3.1.1.1.1.4 Video object
名称 类型 示例 描述
duration int 1 视频的播放时⻓,以毫秒为单位
mimeType int 1 视频类型, 1:video/mp4, mp4格式;2:video/3gpp,3gp格式;3:video/x-msvideo, avi格式;4:video/xflv, flv格式;5:video/x-ms-wmv, wmv格式;6:video/quicktime, mov格式。
width int 600 视频⽂件宽度
height int 500 视频⽂件⾼度
videoUrl string 视频⽂件的url,流视频⽂件为转码以后的地址
coverUrl string 视频⽂件的封⾯图⽚url
length int 视频⼤⼩,以KB为单位
eventTracks EventTrack object array 事件监测ur
3.1.1.1.1.4 EventTrack object
名称 类型 示例 描述
eventType int 事件类型:1:start 视频播放开始;2:firstQuartile视频播放⾄25%时,3:midpoint,视频播放50%时,4:thirdQuartile,视频播放⾄75%时,5:end,视频播放完成时,6:mute,视频静⾳时上报,7:skip:跳过视频时,8:close关闭视频时
eventTrackUrls string array 事件监测url链接列表

4 请求示例

4.1单规格⼴告请求

{
    "version": "2.1.0",
    "device": {
        "deviceId": "ABB59F1C6335A768C21E037695F01464",
        "network": 4,
        "deviceType": 1,
        "imei": "861916030230770",
        "imeiMd5": "ABB59F1C6335A768C21E037695F01464",
        "idfa": "",
        "androidId": "8F029BD7BCF2942",
        "brand": "Huawei",
        "model": "P10",
        "os": "android",
        "osVersion": "5.0",
        "carrier": 1,
        "mac": "0F:00:88:90:DA:75",
        "ip": "123.22.21.2",
        "geo": {
            "longitude": 0.0,
            "latitude": 0.0
        }
    },
    "imps": [{
        "id": 1
    }],
    "app": {
        "pkgName": "sogou.mobile.explorer"
    }
}

4.1.1 单规格⼴告请求返回

{
    "code": 200,
    "data": {
        "groups": [
            {
                "ads": [
                    {
                        "adHeight": 320,
                        "adType": 1,
                        "adWidth": 480,
                        "appInfo": {
                            "deepLink": "",
                            "dfUrl": "http://rd.e.sogou.com/ndf?url=&st=3WTyUgIuQOfSV%2FERRpKp72UtOSpmt7r%2BiOR0w8wRaQZvOQ6eXR%2FSZAlvMyvkH8%2B%2BHQ7Bl2RPn7H0voCaUflAXR%2BIVdzZUEVYR5%2FyiWJxjCyy4hnoQ%2BIVByKSRjzHhWKHVC1h9AITcua0s5ipyGUlAovAp2MutvjwYqB%2B261T6nmvcwFiPwQl%2FSDdWxVgHna3QNYdWf4Nj3Ji4M6bt5Zx7Q%3D%3D",
                            "dsUrl": "http://rd.e.sogou.com/nds?url=&st=3WTyUgIuQOfSV%2FERRpKp72UtOSpmt7r%2BiOR0w8wRaQZvOQ6eXR%2FSZAlvMyvkH8%2B%2BHQ7Bl2RPn7H0voCaUflAXR%2BIVdzZUEVYR5%2FyiWJxjCyy4hnoQ%2BIVByKSRjzHhWKHVC1h9AITcua0s5ipyGUlAovAp2MutvjwYqB%2B261T6nmvcwFiPwQl%2FSDdWxVgHna3QNYdWf4Nj3Ji4M6bt5Zx7Q%3D%3D",
                            "icon": "",
                            "md5": "649778312427ec39c162e10c4cf5d025",
                            "pkgName": "com.myzaker.ZAKER_Phone",
                            "sfUrl": "http://rd.e.sogou.com/nsf?url=&st=3WTyUgIuQOfSV%2FERRpKp72UtOSpmt7r%2BiOR0w8wRaQZvOQ6eXR%2FSZAlvMyvkH8%2B%2BHQ7Bl2RPn7H0voCaUflAXR%2BIVdzZUEVYR5%2FyiWJxjCyy4hnoQ%2BIVByKSRjzHhWKHVC1h9AITcua0s5ipyGUlAovAp2MutvjwYqB%2B261T6nmvcwFiPwQl%2FSDdWxVgHna3QNYdWf4Nj3Ji4M6bt5Zx7Q%3D%3D",
                            "size": 25889851,
                            "version": "8.3.0,701"
                        },
                        "clickTrackUrls": [],
                        "creativeId": 60182167,
                        "downloadAd": 1,
                        "id": 0,
                        "imgs": [
                            {
                                "desc": "",
                                "height": 320,
                                "url": "http://qd.sogoucdn.com/pic/1490184947951.jpg",
                                "width": 480
                            }
                        ],
                        "impTrackUrls": [
                            "http://rd.e.sogou.com/nvw?url=&st=3WTyUgIuQOfSV%2FERRpKp72UtOSpmt7r%2BiOR0w8wRaQZvOQ6eXR%2FSZAlvMyvkH8%2B%2BHQ7Bl2RPn7H0voCaUflAXR%2BIVdzZUEVYR5%2FyiWJxjCyy4hnoQ%2BIVByKSRjzHhWKHVC1h9AITcua0s5ipyGUlAovAp2MutvjwYqB%2B261T6nmvcwFiPwQl%2FSDdWxVgHna3QNYdWf4Nj3Ji4M6bt5Zx7Q%3D%3D&traceId=96cfc2f78a519e0f7bbdcca9c488b741"
                        ],
                        "link": "http://rd.e.sogou.com/nck?url=http%3A%2F%2Fqd.sogoucdn.com%2Fpkg%2F1806%2F45377e8b7d554c8ea2d0570cecade5d6.apk%3Fdn%3DZAKERxinwen8.3.0.apk&st=3WTyUgIuQOfSV%2FERRpKp72UtOSpmt7r%2BiOR0w8wRaQZvOQ6eXR%2FSZAlvMyvkH8%2B%2BHQ7Bl2RPn7H0voCaUflAXR%2BIVdzZUEVYR5%2FyiWJxjCyy4hnoQ%2BIVByKSRjzHhWKHVC1h9AITcua0s5ipyGUlAovAp2MutvjwYqB%2B261T6nmvcwFiPwQl%2FSDdWxVgHna3QNYdWf4Nj3Ji4M6bt5Zx7Q%3D%3D&traceId=96cfc2f78a519e0f7bbdcca9c488b741&sign=09c1dace5e9bf4aced09bca782c3cf76",
                        "nativeAdType": 1,
                        "price": 0,
                        "source": "%e6%90%9c%e7%8b%97%e5%a5%87%e7%82%b9",
                        "summary": "%E6%B5%8B%E8%AF%95%E7%B4%A0%E6%9D%90%E8%AF%B7%E5%8B%BF%E4%B8%8A%E7%BA%BF%7E",
                        "title": "%E6%B5%8B%E8%AF%95%E7%B4%A0%E6%9D%90"
                    }
                ],
                "impId": 1
            }
        ],
        "requestId": "0027900021611552643643586847644",
        "ts": 1552643644075
    },
    "msg": "success"
}

4.3 视频⼴告请求请求示例

{
    "version": "2.2.0",
    "device": {
        "deviceId": "8FB929EC-7690-4726-895C-E9313BE82C3B",
        "network": 6,
        "deviceType": 1,
        "imei": "861916030230770",
        "imeiMd5": "abb59f1c6335a768c21e037695f01464",
        "idfa": "9C287922-EE26-4501-94B5-DDE6F83E1475",
        "androidId": "8F029BD7BCF2942",
        "brand": "Apple",
        "model": "ios",
        "os": "ios",
        "osVersion": "8.0",
        "carrier": 1,
        "mac": "0F:00:88:90:DA:75",
        "ip": "60.129.192.109",
        "geo": {
            "longitude": 0.0,
            "latitude": 0.0
        }
    },
    "imps": [{
        "id": 1,
        "video": {
            "minDuration": 10000,
            "maxDuration": 35000,
            "mimeTypes": "1,2"
        }
    }],
    "app": {
        "pkgName": "sogou.mobile.explorer"
    }
}

4.4 视频⼴告请求返回

{
    "code": 0,
    "data": {
        "requestId": "0000400000171527752074180",
        "ts": 1527752088042,
        "groups": [{
            "impId": 1,
            "ads": [{
                "id": 0,
                "creativeId": 60013468,
                "title": "%E3%83%AA%E3%83%8D%E3%83%BC%E3%82%B8%E3%83%A52%20%E3%83%AC%E3%83%9C%E3%83%AA%",
                "summary": "%E2%80%BBWiFi%E7%92%B0%E5%A2%83%E3%81%A7%E3%81%AE%E3%81%BF%E3%82%A2%E3%83%97%E3%83%AA%E3%",
                "link": "http://test.rd.e.sogou/ck?url=http://Fadstream .123.sogoucdn.com",
                "clickTrackUrls": [
                    "http://sg01.rayjump.com/click? ",
                    "http://test.rd.e.sogou/nck?st = G3RRPMDzlWlKfbVY80ax6wZb9hjJP6ym9IFzR3jCbhPsak21mpgaWQXOgcHy15uTVLaiY % 2 FyNv "
                ],
                "impTrackUrls": [
                    "http://sg01.rayjump.com/impression?",
                    "http://test.rd.e.sogou/nvw?"
                ],
                "adWidth": 1280.0,
                "adHeight": 720.0,
                "adType": 5,
                "downloadAd": 0,
                "source": "%e6%90%9c%e7%8b%97%e5%a5%87%e7%82%b9",
                "nativeAdType": 9,
                "video": {
                    "duration": 15000,
                    "eventTracks": [{
                            "eventType": 1,
                            "eventTrackUrls": [
                                "http://sg01.rayjump.com/trackv2?"
                            ]
                        },
                        {
                            "eventType": 5,
                            "eventTrackUrls": [
                                "http://sg01.rayjump.com/trackv2?
                                p = fHx8fHx8fG9ubGluZV92aWRlb3xWSURFT3x8aW9zfDQuNHwwfDB8fDB8fHx1bmtub3dufHx8fE1O
                                b3JtYWxBbHBoYU1vZGVsUmFua2VyOzEwOzg1Nzs5OzA7OTs3OzFfaWRmYV96ZXJvLTJfY3BlX2Jhc2
                                UtNV9jY3BfZXhwMTswfDViMGZhNTk3YjY2MDVjMGRkYTQ5ZmY4N3x8fHx8fHx8NjAuMTI5LjE5Mi4x
                                MDl8fHx8fHx8fHw5QzI4NzkyMi1FRTI2LTQ1MDEtOTRCNS1EREU2RjgzRTE0NzV8fGFwcGxlfHw1Yj
                                BmYTU5N2I2NjA1YzBkZGE0OWZmODh8NWIwZmE1OTdiNjYwNWMwZGRhNDlmZjg5fHx8fHwxMHx8LHx8
                                fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8 & q = a_i09M6dfgiaj % 2 Fhrc
                                PLg5whoPUYF2IfkRMHrj2GnJ0fUDMfkiMH7xtGkHrGnVF6a50i7Htfn3bDUDFia5Ui7x3DnNPHrD9f
                                bMeiAvefdMeiaRAiUzIiAhbiAfIGnvA6ajbfARBGnlMi % 2 BMeiZ9MidMeiZ9MidetH7PQJcKtY7JX6
                                ajM6juN6oTe6aSIi % 2 BMeiaRAiUzIfav26deXh75 % 2 FD % 2 BSu6aSI6o2IfaSIidMeiaRAiUzIidMM6
                                aSIi % 2 BeIfdeIideuHai9fnR9fn3BigMB6aRAGaVTiajTfUzIideIi % 2 BMM6dMM6deIideYRUjeWUv
                                MR0M0inj % 2 Fiav0WoReR0M0iZzJ6aVTiv % 3 D % 3 D & type = reward_video & r = eyJnaWQiOiJjYzJlOD
                                Q0YTEwMjU1ZDE0YTA1Zjc2Mzk4YTIwNmU0OSIsInRwaWQiOjAsImNyYXQiOjAsImFkdl9jcmlkIjow
                                LCJpY2MiOjEsImdsaXN0IjoiNDAxLDIzODUzODE3MjksMCx8NDAyLDIzODUzODE3MzAsMCx8NDAzLD
                                IzODUzODE3MzEsMCx8NDA1LDIzODUzODE3MzMsMCx8NDA2LDIzODUzODE3MzQsMCx8MTA2LDIzODU0
                                MDAwODksMTE4NDQ5LHwyMDEsMjM4NTQwMTQ2Miw2ODM2OCwxMjgweDcyMHw0MDQsMjM4NTM4MTczMi
                                wwLCIsInBpIjoxMSwicG8iOjExLCJkY28iOjB9 & key = play_percentage & rate = 25 "
                            ]
                        }
                    ],
                    "mimeType": 1,
                    "width": 1280,
                    "height": 720,
                    "length": 3192,
                    "videoUrl": "http://cdn-adn.rayjump.com/cdnadn/18/03/30/11/34/5abdb03e4a3da.mp4",
                }
            }]
        }]
    }
}

5 系统响应码

响应码 说明 原因及解决办法
200 成功
100111 ⼴告请求 解析错误 ⼴告请求解析错误
100117 ⽆效的posid 当传递的pos id⾮法或者platform id与pos id不匹配时均会出现该错误
100121 认证失败 鉴权失败。 请认真参考⽂档中鉴权部分的说明
100211 device信息为空 设备信息为空
100213 设备类型 错误 设备类型deviceType字段⾮接⼝定义的字段
100215 imei校验 错误 imei格式失败,为纯数字
100217 md5值校验失败 md5值校验失败,均为⼤写字⺟
100219 deviceId信息错误 deviceId信息错误
100221 idfa校验失败 idfa格式校验失败, idfa明⽂为16进制32位⻓度,按8-4-4-4-12的⻓度分布
100223 brand未填充 设备类型为⼿机/平板时,需要填充该字段
100225 model未填充 设备类型为⼿机/平板时,需要填充该字段
100227 os未填充 设备类型为⼿机/平板时,需要填充该字段
100231 osVersion 未填充 设备类型为⼿机/平板时,需要填充该字段
100233 填充 设备类型为⼿机时,需要填充该字段
100235 androidId 错误 androidId格式错误
100237 设备唯⼀标识未填充 当os为android时, imei、imeiMd5作为必选字段,可以⼆选⼀。其中imei字段传输明⽂值;当os为ios设备时, idfa字段为必填
100241 ip地址错误 ip信息⾮公⽹IP
100243 mac错误 mac地址错误
100245 ua错误 设备的客户端UA⾮传输设备的webview标准ua
100311 imp信息为空 imp信息为空
100313 imp信息不⽀持多个 imp信息不⽀持多个
100315 impId错误 impId参数错误
100411 过期的请求 系统会对传递的时间戳进⾏校验,如果传递的时间戳+允许时间差<服务器时间,该请求被视为过期的请求。出现错误时请确认传递的时间戳
100413 流量超限 该pos位的流量超出限制流量
100415 keyword⾮法 keyword信息不存在
100417 规格信息错误 standardId不存在
200121 sdk posKey错误 posKey错误
200123 sdk posId错误 sdk posId⾮法
200125 sdk 规格错误 sdk 规格错误
200127 sdk 平台错误 sdk 平台错误
200311 参数解析错误 接⼝参数解析错误
200313 domain 设置错误 domain 设置错误
200315 device唯⼀ID错误 device唯⼀ID设置错误,suv,m,ssuv⾄少填写⼀个
900111 ⾮法的请求参数错误 参数⾮法错误
900113 参数类型匹配错误 参数类型匹配错误
900115 缺少请求参数错误 缺少请求参数
900211 系统错误 系统错误

results matching ""

    No results matching ""