API de AnalyticsEndpoints

Devuelve cuántas veces ocurrió cada evento en la empresa

Devuelve, para cada evento solicitado, cuántas veces ocurrió en los reproductores de la empresa, o en un reproductor cuando se envía `player_id`. Las fechas se leen en UTC. Los eventos que no ocurrieron en el periodo no aparecen.

POST
/events/total_by_company

Authorization

apiToken apiVersion userAgent
X-Api-Token<token>

Accede a la aplicación y copia tu token de API; luego, solo tienes que definir el encabezado X-Api-Token con él.

In: header

X-Api-Version<token>

La versión de la API que se usará. Las versiones compatibles actualmente son:

  • v1: La versión estable actual

Una solicitud sin este encabezado, o con cualquier otro valor, la responde el edge con 404 y {"error_msg":"404 Route Not Found"}.

In: header

User-Agent<token>

Se requiere un User-Agent no vacío que identifique tu integración. Las solicitudes sin él se rechazan en el edge antes de llegar a la API.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/events/total_by_company" \  -H "Content-Type: application/json" \  -d '{    "events": [      "started",      "viewed"    ],    "player_id": "64a5c8072e6fd10009828db2",    "start_date": "2026-09-01 00:00:00",    "end_date": "2026-09-30 23:59:59"  }'
[  {    "event": "started",    "total": 1520,    "total_uniq_sessions": 1210,    "total_uniq_device": 1105  },  {    "event": "viewed",    "total": 4310,    "total_uniq_sessions": 3980,    "total_uniq_device": 3502  }]