跳转至

查看授权信息

多个授权模式,对应的token是不同的,一个token可以为多账户授权验证,也可以为账户管家、代理商作为高级模式的验证。

广告主授权模式下的token是公用的,多个广告主公用一个token。
代理商和账户管家授权模式下,每一个账户授权会产生一个新的token。

请求地址

https://openapi.aiclk.com/oauth2/advertiser/get

请求方式

GET

请求参数

传参形式:Url Param

字段名 类型 是否必须 描述
client_id string 应用ID,开发者应用的唯一标识
token_type string token类型,可选值:access_token 或 refresh_token
token string access token

请求示例

curl -g --location --request GET 'https://openapi.aiclk.com/oauth2/advertiser/get?client_id=2000010776351411&token_type=access_token&token=962118977dbe871028a49f96e27217454b8151341d24200bf5bd69ad4f01c612c5da55a5b32c8d0810deacbf411efacfaf805b7e302fd0'
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL => "https://openapi.aiclk.com/oauth2/advertiser/get?client_id=2000010776351411&token_type=access_token&token=962118977dbe871028a49f96e27217454b8151341d24200bf5bd69ad4f01c612c5da55a5b32c8d0810deacbf411efacfaf805b7e302fd0",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => array(
    "OGW_ACCESS_TOKEN: 8b3834635cd5c572eb962118977dbe871028a49f96e27217454b8151341d24200bf5bd69ad4f01c612c5da55a5b32c8d0810deacbf411efacfaf805b7e3002fd0"
  ),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
Request request = new Request.Builder()
  .url("https://openapi.aiclk.com/oauth2/advertiser/get?client_id=2000010776351411&token_type=access_token&token=962118977dbe871028a49f96e27217454b8151341d24200bf5bd69ad4f01c612c5da55a5b32c8d0810deacbf411efacfaf805b7e302fd0")
  .method("GET", null)
  .addHeader("OGW_ACCESS_TOKEN", "8b3834635cd5c572eb962118977dbe871028a49f96e27217454b8151341d24200bf5bd69ad4f01c612c5da55a5b32c8d0810deacbf411efacfaf805b7e302fd0")
  .build();
Response response = client.newCall(request).execute();
import requests

url = "https://openapi.aiclk.com/oauth2/advertiser/get?client_id=2000010776351411&token_type=access_token&token=962118977dbe871028a49f96e27217454b8151341d24200bf5bd69ad4f01c612c5da55a5b32c8d0810deacbf411efacfaf805b7e302fd0"

payload = {}
headers = {
  'OGW_ACCESS_TOKEN': '8b3834635cd5c572eb962118977dbe871028a49f96e27217454b8151341d24200bf5bd69ad4f01c612c5da55a5b32c8d0810deacbf411efacfaf805b7e302fd0'
}

response = requests.request("GET", url, headers=headers, data = payload)

print(response.text.encode('utf8'))

返回字段

字段名 类型 描述
code string 业务code码
data object 返回结果
- auth_info []object 授权账户列表
-- account_id int 账户ID
-- name string 账户名称
-- role int 授权方式:0-广告主授权,1-代理商授权,2-账户管家授权
-- members []object 代理商授权模式:表示该代理商下的有效广告主列表
账户管家授权模式:表示该管家下绑定的广告主列表
广告主授权模式不显示该字段
--- account_id int 广告账户ID
--- name int 广告账户名称
- token_info object token元数据
-- token string token
-- created_at string 创建时间
-- expires_at string 有效截止时间
-- minute_limit int 分钟级别的频控限制
-- day_limit int 天级别的频控限制
-- day_remain int 天级别的剩余次数
message string 接口返回说明
trace_id string 追踪ID

Tip

频控策略是针对于APP应用维度的,所以同一个应用下的所有token共享接口请求次数

返回示例

{
    "code": 200,
    "data": {
        "auth_info": [
            {
                "account_id": 1500343,
                "name": "agent",
                "role": 2,
                "members": [
                    {
                        "account_id": 1500257,
                        "name": "s86@163.com"
                    }
                ]
            },
            {
                "account_id": 1000021,
                "name": "hunuo_agent01",
                "role": 2,
                "members": [
                    {
                        "account_id": 1000062,
                        "name": "test"
                    },
                    {
                        "account_id": 1000115,
                        "name": "ttt"
                    }
                ]
            }
        ],
        "token_info": {
            "token": "62880e4e4007a6a53d3f4776e1aa7a8d00accc63be1fdb86aa4f4074f96ae9ebfbd0126a7cb7f35e9fb063f035898c80927e4951f073bba5ec87328ed18084ba",
            "created_at": "2020-08-20 17:05:59",
            "expires_at": "2020-11-18 17:05:59",
            "minute_limit": 4000000,
            "day_limit": 4000000,
            "day_remain": 4000000
        }
    },
    "message": "success",
    "trace_id": "19fcb6278f3a0a56"
}