通用声明

一 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服务器按以上规则生成的值不一致,则验证失败