删除子代理
删除代理商名下的子代理账户。
请求地址
https://openapi.aiclk.com/openapi/v1/adaccount/sub-agent/delete
所属权限
ads_write
请求方式
POST
请求参数
| 字段名 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| account_id | int | 是 | 代理商 ID |
Post body(json)
| 字段名 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| sub_agent_id | uint64 | 是 | 要删除的子代理 ID |
删除前需要满足:子代理属于当前代理商、未删除、现金余额和优惠券余额均为 0,且没有有效的广告主绑定关系。删除子代理不会删除或解绑历史广告主关系。
Body 示例
{
"sub_agent_id": 1507987
}
请求示例
curl --location 'https://openapi.aiclk.com/openapi/v1/adaccount/sub-agent/delete?account_id=1000003' \
--header 'Content-Type: application/json' \
--header 'OGW_ACCESS_TOKEN: your_access_token' \
--data '{"sub_agent_id":1507987}'
返回字段释义
| 字段名 | 类型 | 描述 |
|---|---|---|
| code | int | 返回码 |
| message | string | 返回信息 |
| data | json | 返回值 |
| - account_id | int | 子代理 ID |
| - status | string | DELETED 表示删除成功 |
| - recycle_id | int | 回收站记录 ID |
| trace_id | string | trace ID |
返回示例
{
"code": 200,
"message": "success",
"data": {
"account_id": 1507987,
"status": "DELETED",
"recycle_id": 90002
},
"trace_id": "56161c89ed743bff"
}