广告账户信息
获取广告账户详细信息。
请求地址
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": "资质审核不通过"
}
}