账户

获取账户详情、余额、流量总量以及当前使用的 API 密钥信息。

GET /account

返回账户资料、USD 余额、套餐数量、近 30 天流量及调用所用 API 密钥的元数据。

GET/api/v1/account

Authentication: 需要 Bearer 令牌。

Parameters: 无。

response.json

{
  "data": {
    "id":                 4823,
    "email":              "user@example.com",
    "balance_usd":        24.7500,
    "packages_active":    3,
    "packages_total":     4,
    "total_used_gb_30d":  127.4192,
    "member_since":       "2026-01-15T08:32:00+00:00",
    "api_key": {
      "name":         "ci-pipeline",
      "prefix":       "raxy_xY",
      "scopes":       null,
      "last_used_at": "2026-05-29T11:04:12+00:00",
      "expires_at":   null
    }
  },
  "meta": { "version": "v1" }
}

响应字段

字段	类型	描述
`email`	string	账户电子邮件地址。
`balance_usd`	float	当前钱包余额（USD，4 位小数）。
`packages_active`	integer	状态为 active 的套餐数。
`packages_total`	integer	活跃 + 暂停的套餐总数。
`total_used_gb_30d`	float	近 30 天总流量（GB）。
`member_since`	string	账户注册时间戳（ISO 8601）。
`api_key`	object \| null	本次请求所用 API 密钥的元数据 — 见下方。

API 密钥信息

用于确认是哪个密钥发起调用、查看 scopes 与过期日期 — 适合密钥轮换与审计场景。

api_key.json

{
  "name":         "ci-pipeline",
  "prefix":       "raxy_xY",
  "scopes":       ["farm"] | null,
  "last_used_at": "2026-05-29T11:04:12+00:00",
  "expires_at":   "2026-08-01T00:00:00+00:00" | null
}

代码示例

account.sh

curl https://raxyproxy.com/api/v1/account \
     -H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

account.py

import requests

resp = requests.get(
    'https://raxyproxy.com/api/v1/account',
    headers={'Authorization': 'Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'},
    timeout=10,
)
data = resp.json()['data']
print(f"Balance: ${data['balance_usd']:.2f} — 30d traffic: {data['total_used_gb_30d']} GB")

account.mjs

const resp = await fetch('https://raxyproxy.com/api/v1/account', {
    headers: { Authorization: 'Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' },
});
const { data } = await resp.json();
console.log(`Balance $${data.balance_usd.toFixed(2)} — 30d traffic ${data.total_used_gb_30d} GB`);

← 上一页

API 概览

套餐