분석

계정의 집계 사용 통계를 확인하세요 — 업로드 추이, 저장 공간 증가, 파일 유형 분석, 게이트웨이 대역폭. 시간 범위와 API 키로 필터링할 수 있습니다.

Dashboard analytics with uploads chart, storage growth, and file type breakdown

분석 데이터 조회

GET /analytics

매개변수	유형	필수	설명
`from`	number	예	시작 타임스탬프 (Unix 밀리초).
`to`	number	예	종료 타임스탬프 (Unix 밀리초).
`apiKey`	string	아니요	API 키 접두사(예: "bws_0a3ff5f7") 또는 서명된 토큰 접두사(예: "sup_a1b2c3d4")로 필터링합니다. 해당 키 또는 토큰으로 수행된 업로드만 표시됩니다.

요청 예시

bash

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

응답 `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는 from/to 범위에 관계없이 현재 월의 사용량을 반영합니다. apiKey 필터는 업로드 메트릭에만 적용됩니다 — 게이트웨이 대역폭은 계정 전체에 적용됩니다. 서명된 업로드 토큰 접두사는 API 키 접두사와 동일한 필드에 저장되므로, 서명된 토큰 접두사(예: sup_a1b2c3d4)로 필터링하여 특정 서명된 토큰으로 수행된 업로드를 확인할 수 있습니다.

분석 ​

분석 데이터 조회 ​

요청 예시 ​

응답 200 OK ​

분석

분석 데이터 조회

요청 예시

응답 `200 OK`