Statistiques du package
Interrogez l'historique d'utilisation du trafic pour un package proxy par période.
GET /packages/:id/stats
Retourne les comptages de trafic et de requêtes ventilés par jour pour la période choisie. Utile pour créer des tableaux de bord d'utilisation ou déclencher des alertes lorsque le trafic est faible.
GET
/api/v1/packages/{id}/statsParamètres de requête
| Paramètre | Défaut | Options |
|---|---|---|
period | 30d | 7d · 30d · 90d · 1y · day · week · month · 3months · 6months · year |
aggregate | day | minute · hour · day. Taille du bucket pour la série historique. minute n'est autorisé qu'avec period=7d ou day. |
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.
Champs de réponse
| Champ | Type | Description |
|---|---|---|
package_id | integer | Le package auquel ces données appartiennent |
period | string | La période demandée (renvoyée) |
quota_gb | float | Trafic total acheté |
used_gb | float | Trafic total consommé |
available_gb | float | Trafic restant |
usage_pct | float | Pourcentage consommé |
aggregate | string | minute · hour · day |
history[].datetime | string | Jour du calendrier |
history[].traffic_gb | float | Trafic utilisé ce jour-là en GB |
history[].requests | integer | Nombre de requêtes proxy dans ce bucket |
Endpoints liés
La répartition du trafic par hôte (top N destinations) est disponible sur /api/v1/packages/{id}/stats/hosts.
Les événements d'erreur récents (4xx/5xx/timeouts) sont disponibles sur /api/v1/packages/{id}/stats/errors.
Exemples de code
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`);
}