Żądania

GET /api/analytics/requests

GET /api/analytics/requests/:videoId

Dzienne liczby żądań HTTP CDN dla dostarczania wideo. Te liczby pochodzą z logów dostarczania, nie z playera. Dla wyświetleń, czasu oglądania i dokończeń zgłaszanych przez player użyj Odtworzenia.

Pomiń :videoId dla całego workspace. Dodaj id wideo do ścieżki dla jednego wideo.

Wymaga analytics.read. Zobacz Przegląd, aby poznać uwierzytelnianie i zakres kategorii. Klucze API nie mogą przekazywać filtrów kategorii ani Tags na tym endpoincie.

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.
`:videoId`	Nie	Id wideo w ścieżce. Pomiń, aby uzyskać sumy workspace.

Ignite traktuje startDate jako początek tego dnia kalendarzowego, a endDate jako jego koniec. Jeśli co najmniej jeden dzień w zakresie ma dane, dni bez danych są wypełniane wartością views: 0.

Wywołania na poziomie workspace nadal zwracają sumy całego workspace, gdy klucz API jest ograniczony do wybranych kategorii. Wywołanie per wideo kończy się powodzeniem tylko wtedy, gdy to wideo jest w zakresie kategorii klucza.

Żądanie

CURL


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

JavaScript / Node.js


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

PHP


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

Odpowiedź


[
  {
    "date": string,
    "dateString": "2026-08-31",
    "views": number
  },
  [...]
]

dateString to dzień kalendarzowy (YYYY-MM-DD). Użyj go do identyfikacji dnia. views to liczba żądań CDN tego dnia. Zakres bez danych zwraca []. Nieznane wideo lub wideo poza zakresem zwraca 403.

Błędy

Status	Body	Znaczenie
`400`	Zwykły tekst	Brak lub nieprawidłowe `startDate` / `endDate` albo nieprawidłowe `videoId`
`403`	—	Brak `analytics.read`, wyłączony klucz lub id VOD poza zakresem
`403`	`{ "error": "filters_not_supported_for_api_tokens" }`	Filtry kategorii lub Tags w żądaniu z kluczem API