跳转至

广告账户信息

获取广告账户详细信息。

请求地址

https://openapi.aiclk.com/openapi/v1/account/info

所属权限

ads_read

请求方式

GET

请求参数

字段名 类型 是否必须 描述
account_id int 广告主ID(广告投放平台的userID)
query string 请求参数结构,具体字段如下

query参数

字段名 类型 是否必须 描述
fields array 需要的返回字段,允许值:"account_id","username","display_name","balance","coupon","compensation","configure_status","refuse_reason"

query示例

{
       "fields": [
           "account_id",
           "username",
           "balance"
       ]
}

请求示例

 curl -X GET \
  'https://openapi.aiclk.com/openapi/v1/account/info?account_id=1000002&query={"fields":["account_id","username","display_name","balance","coupon","compensation"]}' \
  -H 'Host: openapi.aiclk.com' \
  -H 'OGW_ACCESS_TOKEN: your_access_token'

返回字段释义

字段名 类型 描述
code int 返回码
message string 返回信息
data json 返回值,json格式,包含字段如下
- account_id int 广告主ID
- username string 登录名称
- display_name string 广告主名称
- balance int 现金余额,单位:分
- coupon int 优惠券余额,单位:分
- compensation int 赔付,单位:分
- configure_status string 状态:
停用-DELETE,审核中-PENDING,审核通过-PASSED ,审核不通过-FAILED
- refuse_reason string 审核不通过原因

返回示例

{
  "code": 200,
  "message": "success",
  "data": {
    "account_id": 123235433,
    "username": "登录名称",
    "display_name": "广告主名称",
    "balance": 10000032,
    "coupon": 1000022,
    "compensation": 1000000,
    "configure_status": "FAILED",
    "refuse_reason": "资质审核不通过"
  }
}