回收站列表

查询当前代理商回收站中仍未恢复的广告主和子代理账户。广告主回收记录里的 original_sub_agent_status 表示原绑定子代理的当前状态，会随该子代理删除/恢复实时更新。

请求地址

https://openapi.aiclk.com/openapi/v1/adaccount/account-recycle/index

所属权限

ads_read

请求方式

GET

请求参数

字段名	类型	是否必须	描述
account_id	int	是	代理商 ID
project_type	string	否	all、advertiser、sub_agent，默认 all
keyword	string	否	账户 ID 或删除时保存的账户名称
start_time	string	否	删除时间起点，格式 yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss
end_time	string	否	删除时间终点，只传日期时包含当天
page	int	否	页码，从 1 开始，传 0 按第 1 页处理，默认 1
pageSize	int	否	每页数量，默认 10，最大 100

请求示例

curl --location 'https://openapi.aiclk.com/openapi/v1/adaccount/account-recycle/index?account_id=1000003&project_type=advertiser&keyword=100001&page=1&pageSize=10' \
--header 'OGW_ACCESS_TOKEN: your_access_token'

返回字段释义

字段名	类型	描述
code	int	返回码
message	string	返回信息
data	json	返回值
- result	array	回收站记录，按删除时间倒序
-- recycle_id	int	回收站记录 ID
-- account_id	int	被删除账户 ID
-- account_name	string	删除时保存的账户名称
-- project_type	string	advertiser 广告主，sub_agent 子代理
-- delete_time	string	删除时间
-- operator_name	string	操作人名称
-- operator_source	string	操作来源，MAPI 或 PAGE
-- original_status	int	删除前账户状态
-- original_sub_agent_id	int	删除前绑定的子代理 ID，没有绑定时为 0
-- original_sub_agent_name	string	删除前绑定的子代理名称
-- original_sub_agent_status	string	原绑定子代理当前状态，ACTIVE 表示有效，其他值表示无效
- total	int	总记录数
trace_id	string	trace ID

返回示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": [
      {
        "recycle_id": 90001,
        "account_id": 1000001,
        "account_name": "广告主名称",
        "project_type": "advertiser",
        "delete_time": "2026-08-25 15:00:00",
        "operator_name": "操作人名称",
        "operator_source": "MAPI",
        "original_status": 2,
        "original_sub_agent_id": 1507987,
        "original_sub_agent_name": "子代理名称",
        "original_sub_agent_status": "ACTIVE"
      }
    ],
    "total": 1
  },
  "trace_id": "56161c89ed743bff"
}