Traffico

GET /api/analytics/traffic

Banda giornaliera CDN e storage per il workspace, in byte. Questi valori misurano l’erogazione, non la riproduzione segnalata dal player.

Richiede analytics.read. Vedi Panoramica per autenticazione e ambito di categorie. Questo endpoint è a livello di workspace. Non accetta un id video.

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.

Ignite tratta startDate come l’inizio di quel giorno di calendario e endDate come la fine di quel giorno di calendario. La risposta include al massimo 999 giorni, i più recenti per primi.

Richiesta

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

Risposta

Il body è un elenco paginato (vedi Query). Usa docs per le righe giornaliere.


{
  "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	Descrizione
`incomingTraffic`	Byte caricati nello storage quel giorno.
`outgoingTraffic`	Byte erogati agli spettatori quel giorno. L’Admin UI mostra questo campo nel grafico.
`totalTraffic`	`incomingTraffic` + `outgoingTraffic`.

Tutti i campi di traffico sono interi in byte. Convertili per la visualizzazione. Ad esempio, 1000000000 byte corrispondono a 1 GB.

Errori

Stato	Body	Significato
`400`	Testo semplice	`startDate` / `endDate` mancante o non valido
`403`	—	Manca `analytics.read` o chiave disabilitata