Αναλυτικά

Λάβετε συγκεντρωτικά στατιστικά χρήσης για τον λογαριασμό σας — ανεβάσματα στο χρόνο, αύξηση αποθήκευσης, ανάλυση τύπων αρχείων και εύρος ζώνης gateway. Φιλτράρεται κατά χρονικό εύρος και API key.

Λήψη Αναλυτικών

GET /analytics

Παράμετρος	Τύπος	Απαιτείται	Περιγραφή
from	number	Ναι	Χρονοσήμανση έναρξης σε unix milliseconds.
to	number	Ναι	Χρονοσήμανση λήξης σε unix milliseconds.
apiKey	string	Όχι	Φιλτράρισμα κατά API key prefix (π.χ. "bws_0a3ff5f7") ή signed token prefix (π.χ. "sup_a1b2c3d4"). Εμφανίζει μόνο ανεβάσματα που έγιναν με αυτό το κλειδί ή token.

Παράδειγμα αιτήματος

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

Απάντηση 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 αντικατοπτρίζει τη χρήση του τρέχοντος μήνα ανεξάρτητα από το εύρος from/to. Το φίλτρο apiKey εφαρμόζεται μόνο σε μετρικές ανεβάσματος — το εύρος ζώνης gateway είναι σε επίπεδο λογαριασμού. Τα signed upload token prefix αποθηκεύονται στο ίδιο πεδίο με τα API key prefix, οπότε μπορείτε να φιλτράρετε κατά signed token prefix (π.χ. sup_a1b2c3d4) για να δείτε ανεβάσματα που έγιναν με συγκεκριμένο signed token.