アナリティクス

アカウントの集計使用統計情報を取得します — アップロード推移、ストレージの増加、ファイルタイプの内訳、ゲートウェイ帯域幅。時間範囲と API キーでフィルタリングできます。

アナリティクスの取得

GET /analytics

パラメータ	型	必須	説明
from	number	はい	開始タイムスタンプ（Unix ミリ秒）。
to	number	はい	終了タイムスタンプ（Unix ミリ秒）。
apiKey	string	いいえ	API キープレフィックス（例："bws_0a3ff5f7"）または署名付きトークンプレフィックス（例："sup_a1b2c3d4"）でフィルタリング。そのキーまたはトークンで行われたアップロードのみ表示されます。

リクエスト例

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 フィルターはアップロードメトリクスにのみ適用されます — ゲートウェイ帯域幅はアカウント全体です。署名付きアップロードトークンのプレフィックスは API キープレフィックスと同じフィールドに保存されるため、署名付きトークンプレフィックス（例：sup_a1b2c3d4）でフィルタリングして、特定の署名付きトークンで行われたアップロードを確認できます。