Transfer

GET /api/analytics/traffic

Dzienna przepustowość CDN i storage dla workspace, w bajtach. Te wartości mierzą dostarczanie, a nie odtwarzanie zgłaszane przez player.

Wymaga analytics.read. Zobacz Przegląd, aby poznać uwierzytelnianie i zakres kategorii. Ten endpoint obejmuje cały workspace. Nie przyjmuje id wideo.

Parametry

Parametr	Wymagany	Opis
`startDate`	Tak	Początek zakresu. ISO 8601 lub `YYYY-MM-DD`. Włącznie.
`endDate`	Tak	Koniec zakresu. ISO 8601 lub `YYYY-MM-DD`. Włącznie.

Ignite traktuje startDate jako początek tego dnia kalendarzowego, a endDate jako jego koniec. Odpowiedź zawiera co najwyżej 999 dni, od najnowszych.

Żądanie

CURL


curl -X GET "https://app.ignitevideo.cloud/api/analytics/traffic?startDate=2026-08-01&endDate=2026-08-31" \
-H "Authorization: Bearer YOUR_API_KEY"

JavaScript / Node.js


const response = await fetch(
'https://app.ignitevideo.cloud/api/analytics/traffic?startDate=2026-08-01&endDate=2026-08-31',
{ headers: { Authorization: `Bearer YOUR_API_KEY` } }
);
const data = await response.json();

PHP


$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://app.ignitevideo.cloud/api/analytics/traffic', [
'query' => ['startDate' => '2026-08-01', 'endDate' => '2026-08-31'],
'headers' => ['Authorization' => 'Bearer YOUR_API_KEY'],
]);

Odpowiedź

Body to lista z paginacją (zobacz Zapytania). Użyj docs dla wierszy dziennych.


{
  "docs": [
    {
      "id": string,
      "date": string,
      "incomingTraffic": number,
      "outgoingTraffic": number,
      "totalTraffic": number,
      "workspace": string,
      "createdAt": string,
      "updatedAt": string
    },
    [...]
  ],
  "totalDocs": number,
  "limit": number,
  "page": number,
  "totalPages": number,
  "hasNextPage": boolean,
  "hasPrevPage": boolean
}

Field	Opis
`incomingTraffic`	Bajty wgrane do storage tego dnia.
`outgoingTraffic`	Bajty dostarczone widzom tego dnia. Admin UI pokazuje to pole na wykresie.
`totalTraffic`	`incomingTraffic` + `outgoingTraffic`.

Wszystkie pola transferu to liczby całkowite w bajtach. Przelicz je do wyświetlenia. Na przykład 1000000000 bajtów to 1 GB.

Błędy

Status	Body	Znaczenie
`400`	Zwykły tekst	Brak lub nieprawidłowe `startDate` / `endDate`
`403`	—	Brak `analytics.read` lub wyłączony klucz