Pedidos

GET /api/analytics/requests

GET /api/analytics/requests/:videoId

Contagens diárias de pedidos HTTP de CDN para a entrega de vídeo. Estas contagens vêm dos logs de entrega, não do player. Para visualizações, tempo de visualização e conclusões reportadas pelo player, usa Reproduções.

Omite :videoId para todo o workspace. Acrescenta o id do vídeo ao caminho para um vídeo.

Exige analytics.read. Vê Visão geral para autenticação e âmbito de categoria. As Chaves API não podem passar filtros de categorias ou Tags neste endpoint.

Parâmetros

Parâmetro	Obrigatório	Descrição
`startDate`	Sim	Início do intervalo. ISO 8601 ou `YYYY-MM-DD`. Inclusivo.
`endDate`	Sim	Fim do intervalo. ISO 8601 ou `YYYY-MM-DD`. Inclusivo.
`:videoId`	Não	Id do vídeo no caminho. Omite para os totais do workspace.

O Ignite trata startDate como o início desse dia de calendário e endDate como o fim desse dia de calendário. Se pelo menos um dia do intervalo tiver dados, os dias sem dados são preenchidos com views: 0.

As chamadas ao nível do workspace continuam a devolver totais de todo o workspace quando a Chave API está limitada a categorias específicas. Uma chamada por vídeo só tem sucesso quando esse vídeo está dentro do âmbito de categoria da chave.

Pedido

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

Resposta


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

dateString é o dia de calendário (YYYY-MM-DD). Usa-o para identificar o dia. views é o número de pedidos CDN nesse dia. Um intervalo sem dados devolve []. Um vídeo desconhecido ou fora do âmbito devolve 403.

Erros

Estado	Body	Significado
`400`	Texto simples	`startDate` / `endDate` em falta ou inválido, ou `videoId` inválido
`403`	—	Falta `analytics.read`, chave desativada ou id VOD fora do âmbito
`403`	`{ "error": "filters_not_supported_for_api_tokens" }`	Filtros de categorias ou Tags num pedido com Chave API