Requêtes

GET /api/analytics/requests

GET /api/analytics/requests/:videoId

Comptes quotidiens de requêtes HTTP CDN pour la livraison vidéo. Ces comptes viennent des logs de livraison, pas du player. Pour les vues, le temps de visionnage et les completions rapportés par le player, utilise Lectures.

Omets :videoId pour tout l’espace de travail. Ajoute l’id vidéo au chemin pour une vidéo.

Nécessite analytics.read. Voir Vue d’ensemble pour l’authentification et le périmètre de catégories. Les Clés API ne peuvent pas passer de filtres de catégories ou de Tags sur cet endpoint.

Paramètres

Paramètre	Requis	Description
`startDate`	Oui	Début de la plage. ISO 8601 ou `YYYY-MM-DD`. Inclus.
`endDate`	Oui	Fin de la plage. ISO 8601 ou `YYYY-MM-DD`. Inclus.
`:videoId`	Non	Id vidéo dans le chemin. Omettre pour les totaux de l’espace de travail.

Ignite traite startDate comme le début de ce jour calendaire et endDate comme la fin de ce jour calendaire. Si au moins un jour de la plage a des données, les jours sans données sont remplis avec views: 0.

Les appels à l’échelle de l’espace de travail renvoient toujours les totaux de tout l’espace de travail si la Clé API est limitée à certaines catégories. Un appel par vidéo ne réussit que si cette vidéo est dans le périmètre de catégories de la clé.

Requête

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

Réponse


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

dateString est le jour calendaire (YYYY-MM-DD). Utilise-le comme clé du jour. views est le nombre de requêtes CDN ce jour-là. Une plage sans données renvoie []. Une vidéo inconnue ou hors périmètre renvoie 403.

Erreurs

Status	Body	Signification
`400`	Texte brut	`startDate` / `endDate` manquant ou invalide, ou `videoId` invalide
`403`	—	`analytics.read` manquant, clé désactivée ou id VOD hors périmètre
`403`	`{ "error": "filters_not_supported_for_api_tokens" }`	Filtres de catégories ou de Tags sur une requête avec Clé API