标签增补接入文档

标签增补接入文档

资源请求接口

在第一步授权完成后,==所有的请求都必须携带授权取得的 access_token (除了 授权接口)==,使用方式参照
这里我们使用如下的方式:https://tools.ietf.org/html/rfc6750。接入方需要在 Header 内添加 Authorization,并且 在"Bearer "后加上的 access_token 下面是接口明细:

这里我们使用如下的方式:

GET /resource HTTP/1.1
HOST: server.example.com
Authorization: Bearer mF_9.B5f-4.1JqM
Content-Type: application/json

接入方需要在 Header 内添加 Authorization,并且 在"Bearer "后加上的 access_token

接口版本号

我们建议在请求中通过 Accept header 明确标明接口版本号

Accept:application/vnd.dmp.v1+json

授权接口

授权接口(获取 access_token)

个推会为每个第三方使用者分配一对 user_code 和 auth_code,

第三方根据 user_code 和 auth_code 生成 sign1 值(sign1=MD5(user_code+ MD5(timestamp))) 和 sign2 值(sign2=MD5(user_code+ auth_code+MD5(timestamp))),

然后将 user_code、sign1、sign2 和 timestamp 通过该接口传给个推,个推按照相同的 规则生成 sign 值,通过检验 sign 值是否相同进行鉴权。

接口 URL:https://dmp-hz.abeacon.com/accesser/auth

请求方式:GET 请求参数

字段 必填 类型 字段说明
user_code String 接入方帐号
sign1 String sign1 规则:user_code +md5(timestamp),然后计算其 md5 值
sign2 String sign2 规则:user_code + auth_code + md5(timestamp),然后计 算其 md5 值
timestamp long 时间戳,同 sign 中的 timestamp (这个字段不需要加密)

请求示例:
https://dmp-hz.abeacon.com/accesser/auth? user_code=&sign1=&sign2=&timestamp=

返回 Http 状态码说明

http状态码 说明
200 成功

返回字段说明:

字段 类型 字段说明
code String 登陆结果
access_token String 登陆标示
expires_in long 验证串过期时间,单位 s, 默认是 2 小时(7200s)

返回结果示例

{
    "code":"0",
    "access_token":"asdfkjhqw564fa4sf",
    "expires_in":7200
}

用户 id 标签查询

个推提供给第三方查询对应用户具有的标签

/tags/user

接口URL: https://dmp-hz.abeacon.com/tags/user

请求方式:POST(这里入口参数过多,所以为 POST 方式,但语意为查询)

请求参数(参数都为选填)

字段 必填 类型 字段说明
imeiMD5 选填 string 安卓设备号 32 位 md5 值
macMD5 选填 string ⽹卡地址 md5 值(对 mac 原始值去冒 号⼩写后进⾏ 32 位MD5 加密 )
imsiMD5 选填 string 移动⽤户识别码 md5 值
mb 选填 string 32 位 MD5 加密后的⼿机号码
idfa 选填 string idfa 为 ⼤写形式的原始值
idfaMD5 选填 string 32 位 MD5 加密后的idfa
oaid 选填 string oaid
oaidMD5 选填 string MD5 加密后的oaid
androidId 选填 string androidId
androidIdMD5 选填 string MD5 加密后的androidId

请求示例:

{
    "macMD5": "d826c09af39bcf98d802fb9bc6ceb8af"
}

返回 Http 状态码说明

http状态码 说明
200 成功
400 错误
401 没有授权或授权已过期
403 没有授权

返回字段说明

字段 类型 父节点 字段说明
code String 结果
data array 结果集合

返回结果示例

{
    "code":'0',
    "data": ["100001", "10003","car_H"]
}

接入方配置标签查询

个推提供给第三方可查询的标签列表 (列表更新频率较低,建议定时更新即可)

接口 URL : https://dmp-hz.abeacon.com/config/tags

请求方式 : GET

返回 Http 状态码说明

http状态码 说明
200 成功
400 错误
401 没有授权或已过授权期限
403 没有权限

返回字段说明:

字段 类型 字段说明
tid String TagId
tname String 标签名称

返回结果示例

{
    "code": "0",
    "data":[{
        "tid": "10001",
        "tname": "游戏"
    }, {
        "tid": "10003",
        "tname": "20-14 岁"
    },{
        "tid": "car_H",
        "tname": "汽车_高"
    ]
}

文档中心搜索

技术
咨询

微信扫一扫

随时联系技术支持