Phân tích

Nhận thống kê sử dụng tổng hợp cho tài khoản của bạn -- tải lên theo thời gian, tăng trưởng dung lượng lưu trữ, phân loại loại tệp và băng thông gateway. Có thể lọc theo khoảng thời gian và khóa API.

Lấy Phân tích

GET /analytics

Tham số	Kiểu	Bắt buộc	Mô tả
from	number	Có	Dấu thời gian bắt đầu tính bằng mili giây unix.
to	number	Có	Dấu thời gian kết thúc tính bằng mili giây unix.
apiKey	string	Không	Lọc theo tiền tố khóa API (ví dụ: "bws_0a3ff5f7") hoặc tiền tố token có chữ ký (ví dụ: "sup_a1b2c3d4"). Chỉ hiển thị các lần tải lên được thực hiện bằng khóa hoặc token đó.

Ví dụ yêu cầu

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

Phản hồi 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 phản ánh mức sử dụng tháng hiện tại bất kể khoảng from/to. Bộ lọc apiKey chỉ áp dụng cho số liệu tải lên -- băng thông gateway là toàn tài khoản. Tiền tố token tải lên có chữ ký được lưu trong cùng trường với tiền tố khóa API, vì vậy bạn có thể lọc theo tiền tố token có chữ ký (ví dụ: sup_a1b2c3d4) để xem các lần tải lên được thực hiện bằng token có chữ ký cụ thể.