Paket-Statistiken

Abfrage der Traffic-Nutzungshistorie für ein Proxy-Paket nach Zeitraum.

GET /packages/:id/stats

Gibt Traffic- und Anfragezahlen aufgeschlüsselt nach Tag für den gewählten Zeitraum zurück. Nützlich zum Erstellen von Nutzungs-Dashboards oder zum Auslösen von Warnungen bei niedrigem Traffic.

GET/api/v1/packages/{id}/stats

Abfrageparameter

Parameter	Standard	Optionen
`period`	`30d`	`7d` · `30d` · `90d` · `1y` · `day` · `week` · `month` · `3months` · `6months` · `year`
`aggregate`	`day`	`minute` · `hour` · `day`. Bucket-Größe für die History-Serie. minute ist nur mit period=7d oder day erlaubt.

stats-request.sh

curl "https://raxyproxy.com/api/v1/packages/12/stats?period=7d" \
     -H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

stats-response.json

{
  "data": {
    "package_id":   12,
    "period":       "7d",
    "aggregate":    "day",
    "quota_gb":     10.0,
    "used_gb":      3.2140,
    "available_gb": 6.7860,
    "usage_pct":    32.14,
    "history": [
      { "datetime": "2026-05-09",       "traffic_gb": 0.512100, "requests": 4820 },
      { "datetime": "2026-05-10",       "traffic_gb": 0.480300, "requests": 4612 },
      { "datetime": "2026-05-11",       "traffic_gb": 0.631200, "requests": 5901 },
      { "datetime": "2026-05-12",       "traffic_gb": 0.390000, "requests": 3741 },
      { "datetime": "2026-05-13",       "traffic_gb": 0.520000, "requests": 4900 },
      { "datetime": "2026-05-14",       "traffic_gb": 0.441200, "requests": 4210 },
      { "datetime": "2026-05-15",       "traffic_gb": 0.239188, "requests": 2390 }
    ]
  },
  "meta": { "version": "v1" }
}

With aggregate=hour or aggregate=minute the datetime values include time-of-day, for example 2026-05-15T14:00:00+00:00.

Antwortfelder

Feld	Typ	Beschreibung
`package_id`	integer	Das Paket, zu dem diese Daten gehören
`period`	string	Der angeforderte Zeitraum (zurückgegeben)
`quota_gb`	float	Insgesamt gekaufter Traffic
`used_gb`	float	Gesamter verbrauchter Traffic
`available_gb`	float	Verbleibender Traffic
`usage_pct`	float	Verbrauchter Prozentsatz
`aggregate`	string	minute · hour · day
`history[].datetime`	string	Kalendertag
`history[].traffic_gb`	float	An diesem Tag verbrauchter Traffic in GB
`history[].requests`	integer	Anzahl der Proxy-Anfragen in diesem Bucket

Per-Host-Traffic-Verteilung (Top N Ziele) ist verfügbar unter /api/v1/packages/{id}/stats/hosts.

Aktuelle Fehlerereignisse (4xx/5xx/Timeouts) sind verfügbar unter /api/v1/packages/{id}/stats/errors.

Code-Beispiele

stats.py

import requests

API_KEY    = 'raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
PACKAGE_ID = 12

resp = requests.get(
    f'https://raxyproxy.com/api/v1/packages/{PACKAGE_ID}/stats',
    params={'period': '30d'},
    headers={'Authorization': f'Bearer {API_KEY}'},
    timeout=10,
).json()

data = resp['data']
print(f"Used {data['used_gb']} / {data['quota_gb']} GB ({data['usage_pct']}%)")

for bucket in data['history']:
    print(f"  {bucket['datetime']}: {bucket['traffic_gb']:.4f} GB  {bucket['requests']} requests")

stats.mjs

const API_KEY    = 'raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';
const PACKAGE_ID = 12;

const url  = `https://raxyproxy.com/api/v1/packages/${PACKAGE_ID}/stats?period=30d`;
const resp = await fetch(url, {
    headers: { Authorization: `Bearer ${API_KEY}` },
});
const { data } = await resp.json();

console.log(`Used ${data.used_gb} / ${data.quota_gb} GB (${data.usage_pct}%)`);

for (const day of data.history) {
    console.log(`  ${day.datetime}: ${day.traffic_gb.toFixed(4)} GB  ${day.requests} requests`);
}

Paket-Statistiken

GET /packages/:id/stats

Abfrageparameter

Antwortfelder

Verwandte Endpunkte

Code-Beispiele