Analytiques

Obtenez des statistiques d'utilisation agregees pour votre compte — téléversements dans le temps, croissance du stockage, répartition par type de fichier et bande passante du gateway. Filtrable par plage de temps et clé API.

Obtenir les Analytiques

GET /analytics

Paramètre	Type	Requis	Description
from	number	Oui	Horodatage de debut en millisecondes unix.
to	number	Oui	Horodatage de fin en millisecondes unix.
apiKey	string	Non	Filtrer par préfixe de clé API (ex. "bws_0a3ff5f7") ou préfixe de token signe (ex. "sup_a1b2c3d4"). N'affiche que les téléversements effectues avec cette clé ou ce token.

Exemple de requête

curl "https://api.ipfs.ninja/analytics?from=1711036800000&to=1711641600000" \
  -H "X-Api-Key: bws_your_api_key_here"

Réponse 200 OK

{
  "period": { "from": 1711036800000, "to": 1711641600000 },
  "totals": {
    "uploads": 42,
    "storageMB": 15.3,
    "fileTypes": { "json": 25, "image": 12, "pdf": 5 }
  },
  "daily": [
    { "date": "2026-03-21", "uploads": 20, "sizeMB": 8.1 },
    { "date": "2026-03-22", "uploads": 22, "sizeMB": 7.2 }
  ],
  "storageGrowth": [
    { "date": "2026-03-21", "cumulativeMB": 8.1 },
    { "date": "2026-03-22", "cumulativeMB": 15.3 }
  ],
  "gatewayBandwidthMB": 1200,
  "gatewayBandwidthLimitMB": 51200
}

TIP

gatewayBandwidthMB reflète l'utilisation du mois en cours indépendamment de la plage from/to. Le filtre apiKey ne s'applique qu'aux metriques de téléversement — la bande passante du gateway est au niveau du compte. Les prefixes de tokens de téléversement signes sont stockés dans le même champ que les prefixes de clés API, vous pouvez donc filtrer par préfixe de token signe (ex. sup_a1b2c3d4) pour voir les téléversements effectues avec un token signe spécifique.