获取账户信息

方法: GET

端点: /api/v2/users/account

认证: 支持 Authorization: Bearer <YOUR_API_KEY>、api-key: <YOUR_API_KEY> 和 ?token=<YOUR_API_KEY>。推荐优先使用 Bearer token。

在线试用

GET/api/v2/users/accountGet user account

AuthenticationRequired

Auth mode

Authorization: Bearerapi-key headerQuery token

API token

Stored only in this browser tab. Sent only to https://openapi.coreclaw.com.

Request BodyNot applicable

No JSON request body is defined for this operation.

Send Request Clear all

什么时候使用这个接口

用于验证 token，并读取账户余额和流量额度。

请求示例

curl -X GET "https://openapi.coreclaw.com/api/v2/users/account" \
  -H "Authorization: Bearer YOUR_API_KEY"

响应示例

{
  "code": 0,
  "data": {
    "balance": "100.00",
    "balance_expiration_at": 1782091200
  },
  "message": "success",
  "request_id": "req-123"
}

响应字段

字段	类型	说明
data.balance	string	账户余额（字符串数值）。
data.balance_expiration_at	integer	余额到期时间，Unix 秒。余额可能到期；具体到期策略请以 Console 或支持为准。

注意事项

• API v2 同时支持 Bearer token、旧版 api-key 请求头和 query token；新集成建议优先使用 Bearer token。

HTTP 响应

HTTP 状态	应用代码	含义
200	0	请求成功。
400	11000	请求参数不合法。
401	12001	认证缺失或无效。
404	11004	目标资源不存在。
429	13000	请求过于频繁。
500	10000	服务端内部错误。