启用或停用动态子账号

PATCH /open-api/v1/dynamic/accounts/{id}/status

Base URL：https://api.ipbunker.online/gin。

认证

在请求头传入 X-API-Key。

路径与查询参数

字段	位置	类型	必填	约束	说明
id	path	string	是	—	动态账号 ID

JSON 请求体

字段	类型	必填	约束	说明
user_enabled	boolean	是	—	是否允许用户使用该子账号

请求示例

curl --request PATCH \
  --url 'https://api.ipbunker.online/gin/open-api/v1/dynamic/accounts/1912345678901234567/status' \
  --header 'Accept: application/json' \
  --header 'X-API-Key: <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "user_enabled": true
}'

成功响应中的 data

接口使用 code、msg、data、next 响应结构。HTTP 200 也可能包含非零业务错误码；先检查 code。

字段	类型	必填	约束	说明
data.id	string	否	—	动态账号 ID
data.resource_status	string	否	enum: ACTIVE, REMOVED	平台资源状态
data.user_enabled	boolean	否	—	用户期望启用状态
data.flow_blocked	boolean	否	—	是否因流量余额不足被阻断
data.available	boolean	否	—	是否满足平台可用条件
data.control_pending	boolean	否	—	内部控制状态是否仍在异步收敛

接口说明

设置用户期望启用状态；控制异步收敛时通过 control_pending 判断是否仍在同步

相关约定

请求规范 · 响应结构 · 错误码 · API 接口目录