Konto
DocsKonto

Konto

Rufen Sie Kontodetails, Guthaben, Traffic-Summen und Informationen zum verwendeten API-Schlüssel ab.

GET /account

Gibt Kontoprofil, USD-Guthaben, Paketanzahl, 30-Tage-Traffic und Metadaten zum verwendeten API-Schlüssel zurück.

GET/api/v1/account

Authentication: Bearer-Token erforderlich.

Parameters: keine.

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" }
}

Antwortfelder

FeldTypBeschreibung
emailstringE-Mail-Adresse des Kontos.
balance_usdfloatAktuelles Wallet-Guthaben in USD (4 Dezimalstellen).
packages_activeintegerAnzahl der Pakete mit Status „active".
packages_totalintegerAktive und pausierte Pakete.
total_used_gb_30dfloatGesamtverbrauch der letzten 30 Tage über alle Pakete in GB.
member_sincestringZeitstempel der Kontoregistrierung (ISO 8601).
api_keyobject | nullMetadaten zum verwendeten API-Schlüssel — siehe unten.

API-Schlüssel-Info

Damit lässt sich prüfen, welcher Schlüssel die Anfrage stellt, welche Scopes er hat und wann er abläuft — nützlich für Rotations- und Audit-Pipelines.

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
}

Code-Beispiele

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