Tráfico

GET /api/analytics/traffic

Ancho de banda diario de CDN y almacenamiento para el espacio de trabajo, en bytes. Estos valores miden la entrega, no la reproducción que informa el player.

Requiere analytics.read. Consulta Resumen para autenticación y alcance de categorías. Este endpoint es de todo el espacio de trabajo. No acepta un id de vídeo.

Parámetros

Parámetro	Obligatorio	Descripción
`startDate`	Sí	Inicio del rango. ISO 8601 o `YYYY-MM-DD`. Inclusivo.
`endDate`	Sí	Fin del rango. ISO 8601 o `YYYY-MM-DD`. Inclusivo.

Ignite trata startDate como el inicio de ese día de calendario y endDate como el final de ese día de calendario. La respuesta incluye como máximo 999 días, los más recientes primero.

Solicitud

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

Respuesta

El body es una lista paginada (consulta Consultas). Usa docs para las filas diarias.


{
  "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	Descripción
`incomingTraffic`	Bytes subidos al almacenamiento ese día.
`outgoingTraffic`	Bytes entregados a los espectadores ese día. La Admin UI muestra este campo en el gráfico.
`totalTraffic`	`incomingTraffic` + `outgoingTraffic`.

Todos los campos de tráfico son enteros en bytes. Conviértelos para mostrarlos. Por ejemplo, 1000000000 bytes son 1 GB.

Errores

Status	Body	Significado
`400`	Texto plano	Falta `startDate` / `endDate` o no es válido
`403`	—	Falta `analytics.read` o clave deshabilitada