Ejecutar consultas con la API de Triton Metrics

Anterior Siguiente

Los paneles de inteligencia empresarial de su empresa pueden recuperar datos analíticos de Triton Metrics con la API de Triton Metrics. Esta API le permite ejecutar las consultas que guardó en estas aplicaciones de Triton Explore:

  • Webcast Metrics

  • Podcast Metrics

  • Podcast Video

  • Demos+

  • Lineup Explore

  • Informes de regalías

  • TAP Explore (requiere licencia)

  • TAP Declaraciones juradas

Requisitos

Para usar la API de Triton Metrics, necesita lo siguiente:

  • Credenciales de la API de Triton Metrics. El acceso a la API de Triton Metrics es parte de un servicio pago. Para obtener más información, por favor comuníquese con Triton Digital.

  • Una consulta de Triton Explore que creó y guardó con sus credenciales de la API de Triton Metrics.

Migrar a Triton Metrics API V2

Cambie a la versión 2 de la API de Triton Metrics. La API v1 de Triton Metrics ya no es compatible y quedará obsoleta el 26 y 2026 de enero.

La API v1 obsoleta:  https://metrics-api.tritondigital.com/docs/

La API v2: https://metrics.api.tritondigital.com/docs

La API v2 de Triton Metrics tiene estos cambios:

  • Autenticación: solo con el token JWT, solicitado desde la API de inicio de sesión de Triton.

  • Un extremo único y más simple: los múltiples extremos para solicitar informes en v1 se han combinado en un solo extremo.

Obtener un ID de consulta

Puede guardar consultas en las aplicaciones de Triton Metrics. Cada consulta guardada tiene su propio ID de consulta, que puede usar con la API de Triton Metrics.

  1. Inicie sesión en una aplicación de Triton Metrics con sus credenciales de la API de Triton Metrics.

  2. Configure y guarde una consulta. Consulte Guardar y programar consultas.

  3. Vaya a Saved Queries (Consultas guardadas ) en la aplicación Triton Metrics donde guardó su consulta.

  4. En el menú de opciones de la consulta, seleccione Copiar ID.

  5. Seleccione Copiar para copiar el ID en el portapapeles.

  6. Seleccione Aceptar.

  7. Pegue el ID de consulta en la solicitud de API de la aplicación empresarial.

Usar la API

Para obtener información detallada, consulte la documentación de la API de Triton Metrics: https://metrics.api.tritondigital.com/docs.

Al crear y guardar consultas para usar con la API, asegúrese de iniciar sesión con sus credenciales de la API de Triton Metrics. La API de Triton Metrics solo puede acceder a las búsquedas guardadas por el mismo usuario que las creó.

Las consultas guardadas incluyen una fecha de inicio y finalización, ya sea como fechas específicas o como ajustes preestablecidos, como los últimos 7 días. Puede anular esas fechas en sus solicitudes de API.

Parámetro

Descripción

Obligatorio

id

El identificador de consulta de una consulta guardada.

start

Fecha de inicio de los datos consultados. El valor predeterminado es la fecha de inicio en la consulta guardada.

No

end

La fecha posterior al último día completo para el que desea datos.

Por ejemplo: end=2021-04-01 Devuelve datos hasta el final del 2021-03-31.

El valor predeterminado es la fecha de finalización utilizada en la consulta guardada.

No

Límites

Algunos de estos límites también se encuentran en su acuerdo de licencia con Triton Digital. El acuerdo de licencia tiene prioridad.

  • Limitación de API: Si se realizan más de 10 solicitudes en un minuto, la API devuelve un error 429 ("demasiadas solicitudes") y tendrá que esperar un minuto antes de realizar otra solicitud.

  • Dimensiones y límites de fila: consulte la interfaz de usuario y las herramientas de exportación de Triton Metrics.

  • Límite de solicitud mensual: cada licencia de API permite hasta 1000 llamadas/eventos de API por mes.