Exécuter des requêtes avec l’API Triton Metrics

Précédent Suivant

Les tableaux de bord de veille stratégique de votre entreprise peuvent récupérer les données d’analyse de Triton Metrics grâce à l’API Triton Metrics. Cette API vous permet d’exécuter les requêtes que vous avez enregistrées dans les applications Triton Explore suivantes :

  • Webcast Metric

  • Podcast Metrics

  • Podcast Video

  • Démos+

  • Lineup Explore

  • Rapports sur les redevances

  • TAP Explore (licence requise)

  • Témoignages concernant TAP

Exigences

Pour utiliser l’API Triton Metrics, vous avez besoin des éléments suivants :

  • Identifiants API Triton Metrics. L'accès à l'API Triton Metrics fait désormais partie d'un service payant. Pour plus d’informations, veuillez contacter Triton Digital.

  • Une requête Triton Explore que vous avez créée et enregistrée avec vos identifiants d’API Triton Metrics.

Migrer vers l'API Triton Metrics V2

Veuillez passer à la v2 de l’API Triton Metrics. La v1 de l'API Triton Metrics n’est plus prise en charge et sera obsolète le 26 janvier 2026.

L’API v1 obsolète :  https://metrics-api.tritondigital.com/docs/

L’API v2 : https://metrics.api.tritondigital.com/docs

L’API Triton Metrics v2 présente les modifications suivantes :

  • Authentification : avec jeton JWT uniquement, demandée à l’API Triton Login.

  • Un point de terminaison unique plus simple : les différents points de terminaison pour la demande de rapports dans la version 1 ont été combinés en un seul point de terminaison.

Obtenir un identifiant de requête

Vous pouvez enregistrer des requêtes dans les applications Triton Metrics. Chaque requête enregistrée possède son propre identifiant de requête, que vous pouvez utiliser avec l’API Triton Metrics.

  1. Connectez-vous à une application Triton Metrics avec vos identifiants API Triton Metrics.

  2. Configurez et enregistrez une requête. Reportez-vous à la section Enregistrement et planification des requêtes.

  3. Accédez à Requêtes enregistrées dans l’application Triton Metrics où vous avez enregistré votre requête.

  4. Dans le menu d’options de la requête, sélectionnez Copier l’ID.

  5. Sélectionnez Copier pour copier l’ID dans votre presse-papiers.

  6. Sélectionnez OK.

  7. Collez l’ID de requête dans la demande d’API de votre application métier.

Utiliser l’API

Pour plus d’informations, consultez la documentation de l’API Triton Metrics : https://metrics.api.tritondigital.com/docs.

Lorsque vous créez et enregistrez des requêtes à utiliser avec l’API, assurez-vous de vous connecter avec vos identifiants d’API Triton Metrics. L'API Triton Metrics est uniquement capable d'accéder aux requêtes qui ont été enregistrées par l'utilisateur qui a créé les requêtes.

Les requêtes enregistrées incluent une date de début et de fin, soit sous forme de dates spécifiques, soit sous forme de préréglages, tels que les 7 derniers jours. Vous pouvez remplacer ces dates dans vos requêtes API.

Paramètre

Description

Requis

id

ID de requête pour une requête enregistrée.

Oui

démarrer

Date de début des données interrogées. La valeur par défaut est la date de début dans la requête enregistrée.

Non

end

Date postérieure au dernier jour complet pour lequel vous souhaitez obtenir des données.

Par exemple,  end=2021-04-01 renvoie les données jusqu’à la fin du 2021-03-31.

La valeur par défaut est la date de fin utilisée dans la requête enregistrée.

Non

Limites

Certaines de ces limites figurent également dans votre contrat de licence avec Triton Digital. Le contrat de licence prévaut.

  • Limitation de l’API : si plus de 10 requêtes sont effectuées en une minute, l’API renvoie une erreur 429 (« trop de requêtes ») et vous devrez attendre une minute avant d’effectuer une autre requête.

  • Dimensions et limites de lignes : consultez l’interface utilisateur et les outils d’exportation de Triton Metrics.

  • Limite de demande mensuelle : chaque licence d’API permet d’effectuer jusqu’à 1000 appels/événements d’API par mois.