Richieste

GET /api/analytics/requests

GET /api/analytics/requests/:videoId

Conteggi giornalieri di richieste HTTP CDN per l’erogazione video. Questi conteggi arrivano dai log di erogazione, non dal player. Per visualizzazioni, tempo di visione e completamenti segnalati dal player, usa Riproduzioni.

Ometti :videoId per l’intero workspace. Aggiungi l’id video al percorso per un video.

Richiede analytics.read. Vedi Panoramica per autenticazione e ambito di categorie. Le chiavi API non possono passare filtri di categorie o Tags su questo endpoint.

Parametri

Parametro	Obbligatorio	Descrizione
`startDate`	Sì	Inizio dell’intervallo. ISO 8601 o `YYYY-MM-DD`. Inclusivo.
`endDate`	Sì	Fine dell’intervallo. ISO 8601 o `YYYY-MM-DD`. Inclusivo.
`:videoId`	No	Id video nel percorso. Ometti per i totali del workspace.

Ignite tratta startDate come l’inizio di quel giorno di calendario e endDate come la fine di quel giorno di calendario. Se almeno un giorno dell’intervallo ha dati, i giorni senza dati vengono riempiti con views: 0.

Le chiamate a livello di workspace restituiscono comunque i totali dell’intero workspace se la chiave API è limitata a categorie specifiche. Una chiamata per video ha successo solo se quel video è all’interno dell’ambito di categorie della chiave.

Richiesta

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'],
]);

Risposta


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

dateString è il giorno di calendario (YYYY-MM-DD). Usalo come chiave del giorno. views è il numero di richieste CDN quel giorno. Un intervallo senza dati restituisce []. Un video sconosciuto o fuori ambito restituisce 403.

Errori

Stato	Body	Significato
`400`	Testo semplice	`startDate` / `endDate` mancante o non valido, oppure `videoId` non valido
`403`	—	Manca `analytics.read`, chiave disabilitata o id VOD fuori ambito
`403`	`{ "error": "filters_not_supported_for_api_tokens" }`	Filtri di categorie o Tags su una richiesta con chiave API