アカウント
Docsアカウント

アカウント

アカウント情報、残高、トラフィック合計、使用中の 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" }
}

レスポンスフィールド

フィールドタイプ説明
emailstringアカウントのメールアドレス。
balance_usdfloat現在のウォレット残高(USD、小数 4 桁)。
packages_activeintegerステータスが active のパッケージ数。
packages_totalintegerアクティブ + 一時停止中のパッケージ。
total_used_gb_30dfloat過去 30 日間のトラフィック合計(GB)。
member_sincestringアカウント登録タイムスタンプ(ISO 8601)。
api_keyobject | null使用中の API キーのメタデータ — 下記参照。

API キー情報

どのキーがリクエストを行っているか、スコープ、有効期限の確認に便利 — ローテーションや監査に役立ちます。

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`);