查询动态子账号详情

按 ID 查询一个动态子账号的状态、用量和连接密码。

接口信息

项目	内容
Method	GET
Path	/open-api/v1/dynamic/accounts/{id}
认证	X-API-Key
处理方式	同步

路径参数

参数	类型	必填	说明
id	string	是	动态子账号 ID

不接受 Query 参数。

请求示例

curl --request GET \
  --url 'https://api-test.puraroute.com/gin/open-api/v1/dynamic/accounts/1912345678901234567' \
  --header 'Accept: application/json' \
  --header 'X-API-Key: <YOUR_API_KEY>'

响应参数

响应字段与创建动态子账号相同。

limit_traffic_gb 始终返回非空的 6 位小数字符串；0.000000 表示不限额。

成功响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "id": "1912345678901234567",
    "sub_account": "team_a_01",
    "password": "example-secret",
    "limit_traffic_gb": "10.000000",
    "lifetime_used_gb": "1.250000",
    "resource_status": "ACTIVE",
    "user_enabled": true,
    "flow_blocked": false,
    "available": true,
    "control_pending": false,
    "last_usage_sync_time": "2026-08-24T15:20:00.000+08:00",
    "create_time": "2026-08-20T10:00:00.000+08:00",
    "update_time": "2026-08-24T15:30:00.000+08:00"
  },
  "next": null
}

可能的错误码

code	说明
300001	账号不存在或不可访问
400001	认证失败
400009	路径或请求参数不符合要求
500000	系统处理失败，请求未完成

响应包含密码，不应缓存或写入普通日志。