Skip to content

Analyse

Få aggregert bruksstatistikk for kontoen din — opplastinger over tid, lagringsvekst, filtypefordeling og gateway-båndbredde. Filtrerbar etter tidsintervall og API-nøkkel.

Dashboard-analyse med opplastingsdiagram, lagringsvekst og filtypefordeling

Hent analyse

GET /analytics

ParameterTypePåkrevdBeskrivelse
fromnumberJaStarttidsstempel i unix-millisekunder.
tonumberJaSlutttidsstempel i unix-millisekunder.
apiKeystringNeiFiltrer etter API-nøkkelprefiks (f.eks. "bws_0a3ff5f7") eller signert tokenprefiks (f.eks. "sup_a1b2c3d4"). Viser bare opplastinger gjort med den nøkkelen eller tokenet.

Eksempelforespørsel

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

Svar 200 OK

json
{
  "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 gjenspeiler inneværende måneds bruk uavhengig av from/to-intervallet. apiKey-filteret gjelder bare for opplastingsmetrikker — gateway-båndbredde er kontobasert. Signerte opplastingstokeners prefikser lagres i samme felt som API-nøkkelprefikser, så du kan filtrere etter signert tokenprefiks (f.eks. sup_a1b2c3d4) for å se opplastinger gjort med et spesifikt signert token.