跳转至

删除子代理

删除代理商名下的子代理账户。

请求地址

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"
}