Passer au contenu principal

Utilisation des endpoints API

A
Écrit par Arek
Mis à jour aujourd’hui

La page Utilisation des endpoints API vous donne une vue complète des performances de vos intégrations API. Vous pouvez surveiller l’état de santé de chaque endpoint, suivre l’avancement de l’implémentation et consulter les logs des appels API pour analyser les erreurs.

Ce dont vous aurez besoin :

  • Accès à Vehicle Management.

  • L’onglet API Endpoints.


🧭 Comment accéder

Accédez à Vehicle Management et sélectionnez l’onglet API Endpoints dans la navigation du haut.


📋 Liste des endpoints

La page affiche tous vos endpoints API actifs, triés par ordre alphabétique. Chaque carte d’endpoint affiche :

  • Endpoint name — le nom de l’endpoint API.

  • API Health status — un indicateur coloré de l’état actuel :

    • 🟢 Healthy (vert) — l’endpoint fonctionne normalement.

    • 🟡 Concerning (jaune) — des erreurs ont été détectées ; à surveiller.

    • 🔴 High error rate (rouge) — une part importante des appels récents échoue.

    • All calls failed (rouge) — tous les appels récents ont renvoyé une erreur.

  • Implementation status — l’étape de déploiement de l’endpoint :

    • Implemented (vert) — l’endpoint est entièrement en production.

    • 🛠️ Under implementation (jaune) — l’endpoint est encore en cours de mise en place.

    • 💤 Inactive > 30 days (gris) — aucun appel n’a été enregistré depuis plus de 30 jours.


🔎 Détails de l’endpoint

Cliquez sur une carte d’endpoint pour l’ouvrir. La vue développée inclut :

  • Source — l’identifiant de l’intégration qui effectue les appels.

  • First Call — la date du tout premier appel enregistré.

  • Last Call — la date de l’appel le plus récent.

  • Implemented At — la date à laquelle l’endpoint a été marqué comme implémenté (si applicable).

  • Webhook Status — le statut actuel de l’abonnement webhook associé (si applicable).

  • Tableau Recent Activity — une ventilation jour par jour avec la date, le nombre d’appels et le code HTTP pour chaque entrée. Les codes sont colorés : vert pour succès (2xx) et rouge pour erreurs (4xx/5xx).


🧾 Consulter le détail des appels API

Dans le tableau Recent Activity, cliquez sur "View details" sur une ligne (ou cliquez directement sur la ligne) pour ouvrir la fenêtre API Call History. Cette fenêtre affiche :

  • Un en-tête récapitulatif avec le nom de l’endpoint, la source, la date et le nombre total d’appels.

  • Un log défilant des appels API individuels avec :

    • numéro de ligne

    • code HTTP (coloré)

    • URL de requête

    • horodatage (en UTC)

  • Pour les réponses d’erreur (4xx/5xx), cliquez sur expand pour voir le message d’erreur et le payload de la requête, utile pour le debugging.

Le log charge les résultats par pages de 50 et récupère automatiquement la suite au fur et à mesure du défilement.

💡Note : la synchronisation des logs détaillés peut être retardée. Les logs très récents d’aujourd’hui peuvent ne pas être visibles immédiatement. Les payloads de requête ne sont enregistrés que pour les réponses d’erreur (4xx/5xx).

Besoin d’aide ?

  • Ask our AI Assistant : pour une aide en temps réel, utilisez l’AI Assistant directement dans l’interface de la plateforme Visibility.

  • Send Feedback : votre avis compte. Cliquez sur l’icône "?" en bas à gauche puis sélectionnez "Send feedback."

  • Support Portal : pour les problèmes techniques nécessitant une assistance humaine, consultez notre Support Portal.

Avez-vous trouvé la réponse à votre question ?