Traffic

GET /api/analytics/traffic

Tägliche CDN- und Storage-Bandbreite für den Workspace, in Bytes. Diese Werte messen die Auslieferung, nicht das Playback, das der Player berichtet.

Erfordert analytics.read. Siehe Übersicht für Authentifizierung und Kategorie-Scope. Dieser Endpoint gilt workspace-weit. Er akzeptiert keine Video-ID.

Parameter

Parameter	Erforderlich	Beschreibung
`startDate`	Ja	Start des Bereichs. ISO 8601 oder `YYYY-MM-DD`. Inklusive.
`endDate`	Ja	Ende des Bereichs. ISO 8601 oder `YYYY-MM-DD`. Inklusive.

Ignite behandelt startDate als Beginn dieses Kalendertags und endDate als Ende dieses Kalendertags. Die Antwort enthält höchstens 999 Tage, neueste zuerst.

Anfrage

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

Antwort

Der Body ist eine paginierte Liste (siehe Abfragen). Nutze docs für die Tageszeilen.


{
  "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	Beschreibung
`incomingTraffic`	An diesem Tag in den Storage hochgeladene Bytes.
`outgoingTraffic`	An diesem Tag an Zuschauer ausgelieferte Bytes. Die Admin-UI zeigt dieses Feld im Chart.
`totalTraffic`	`incomingTraffic` + `outgoingTraffic`.

Alle Traffic-Felder sind Ganzzahlen in Bytes. Rechne sie für die Anzeige um. Zum Beispiel sind 1000000000 Bytes 1 GB.

Fehler

Status	Body	Bedeutung
`400`	Klartext	Fehlendes oder ungültiges `startDate` / `endDate`
`403`	—	Fehlendes `analytics.read` oder deaktivierter Key