创建动态子账号

POST /open-api/v1/dynamic/accounts

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

认证

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

JSON 请求体

字段	类型	必填	约束	说明
request_no	string	是	minLength: 1; maxLength: 64; pattern: ^[A-Za-z0-9_-]{1,64}$	调用方幂等请求号，1～64 位，仅允许字母、数字、下划线和连字符
sub_account	string	是	—	用户可见且永久占用的子账号名
limit_traffic_gb	string	否	—	可选流量限额 GB，使用字符串避免精度丢失

请求示例

curl --request POST \
  --url 'https://api.ipbunker.online/gin/open-api/v1/dynamic/accounts' \
  --header 'Accept: application/json' \
  --header 'X-API-Key: <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "request_no": "req_20260824_001",
  "sub_account": "team_a_01"
}'

成功响应中的 data

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

字段	类型	必填	约束	说明
data.id	string	否	—	动态账号 ID
data.sub_account	string	否	—	用户可见且创建后不可修改的子账号名
data.password	string	否	—	代理连接密码；敏感字段
data.limit_traffic_gb	string	否	—	生命周期累计流量限额 GB；空值表示不限流量
data.lifetime_used_gb	string	否	—	生命周期累计已使用流量 GB
data.resource_status	string	否	enum: ACTIVE, REMOVED	平台资源状态
data.user_enabled	boolean	否	—	用户期望启用状态
data.flow_blocked	boolean	否	—	是否因流量余额不足被阻断
data.available	boolean	否	—	是否满足平台可用条件
data.control_pending	boolean	否	—	内部控制状态是否仍在异步收敛
data.last_usage_sync_time	string	否	format: date-time	最近一次用量同步时间；尚未同步时为空
data.create_time	string	否	format: date-time	账号创建时间，GMT+8 带偏移 ISO-8601
data.update_time	string	否	format: date-time	账号更新时间，GMT+8 带偏移 ISO-8601

接口说明

创建用户可见且不可修改的子账号；request_no 在当前用户和本操作内保留 24 小时

相关约定

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