标签增补接入文档

资源请求接口

在第一步授权完成后，==所有的请求都必须携带授权取得的 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 请求参数

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

返回 Http 状态码说明

返回字段说明:

返回结果示例

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

用户 id 标签查询

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

/tags/user

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

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

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

请求示例:

{
    "macMD5": "d826c09af39bcf98d802fb9bc6ceb8af"
}

返回 Http 状态码说明

返回字段说明

返回结果示例

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

接入方配置标签查询

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

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

请求方式 : GET

返回 Http 状态码说明

返回字段说明:

返回结果示例

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