一 API域名
正式:https://open.adx.qq.com/
沙箱:https://opentest.adx.qq.com/
二 API参数(每个API都必须包含的参数)
参数名称 | 是否必须 | 含义 |
---|---|---|
dsp_id | 是 | DSP在AdX系统中的ID |
token | 是 | AdX系统给DSP分配的token值,用来进行权限验证 |
time | 是 | 请求发生的时间戳,10位数字 |
sig | 是 | 加密串32位md5,生成规则见下文 |
三 编码方式
若无特殊说明或响应头中的Content-Type未指定编码,请求与响应中的字节编码均使用UTF-8(无BOM头)。
四 API请求
HTTP Method:POST
HTTP Header Content-Type:application/json或Content-Type:application/x-www-form-urlencoded
五 JSON 数据示例
{
“data”: <requestdata>,
“dsp_id”:10001,
“token”:”1502dfcd79dbbd08a0203dbde9a9cc59″,
“time”:”1497196800″,
“sig”:”32f0a07d6884f179113ff144c7c988be”
}
注:requestdata为json array类型
六 sig 生成规则
sig=md5(dsp_id+token+time)
例:
sig=md5(100011502dfcd79dbbd08a0203dbde9a9cc591497196800)
sig=32f0a07d6884f179113ff144c7c988be
注:腾讯AdX服务器会对time与sig参数进行校验
(1)time与AdX服务器时间gap超过30min,则验证失败
(2)sig值和AdX服务器按以上规则生成的值不一致,则验证失败