Analysen

Erhalten Sie aggregierte Nutzungsstatistiken für Ihr Konto — Uploads über die Zeit, Speicherwachstum, Dateityp-Aufschlüsselung und Gateway-Bandbreite. Filterbar nach Zeitraum und API-Schlüssel.

Analysen abrufen

GET /analytics

Parameter	Typ	Erforderlich	Beschreibung
from	number	Ja	Startzeitstempel in Unix-Millisekunden.
to	number	Ja	Endzeitstempel in Unix-Millisekunden.
apiKey	string	Nein	Nach API-Schlüssel-Präfix filtern (z. B. "bws_0a3ff5f7") oder signiertem Token-Präfix (z. B. "sup_a1b2c3d4"). Zeigt nur Uploads an, die mit diesem Schlüssel oder Token durchgeführt wurden.

Beispielanfrage

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

Antwort 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 spiegelt die Nutzung des aktuellen Monats wider, unabhängig vom from/to-Bereich. Der apiKey-Filter gilt nur für Upload-Metriken — die Gateway-Bandbreite ist kontoweit. Signierte Upload-Token-Präfixe werden im selben Feld wie API-Schlüssel-Präfixe gespeichert, sodass Sie nach signiertem Token-Präfix (z. B. sup_a1b2c3d4) filtern können, um Uploads zu sehen, die mit einem bestimmten signierten Token durchgeführt wurden.