API des services Web – Aperçu et prise en main
L'API des services Web de TripLog vous permet d'intégrer les données TripLog directement dans vos propres systèmes. Utilisez-la pour récupérer les enregistrements de trajets, gérer les utilisateurs, extraire les données de dépenses, et plus encore — le tout via des requêtes HTTP standard et JSON.
Qui peut l'utiliser : L'API est disponible pour les abonnés au forfait Enterprise. L'accès à l'API est géré au niveau de l'organisation par un administrateur principal.
URL de base
Toutes les requêtes API sont effectuées vers :
https://app.triplog.net/web/api/
Authentification
Chaque requête doit inclure la clé API de votre organisation dans l'en-tête Authorization :
Authorization: apikey YOUR_API_KEY
Pour générer ou récupérer votre clé API, consultez Comment générer la clé API.
Gardez votre clé API sécurisée. Elle accorde un accès complet en lecture/écriture aux données de votre organisation. Ne l'exposez pas dans du code côté client ou dans des dépôts publics.
Format de la requête
Protocole : HTTPS uniquement
Méthode : GET ou POST selon le point de terminaison (indiqué dans chaque article)
Content-Type :
application/jsonpour les requêtes POST avec un corps de requêteFormat de réponse : JSON
Taille de la réponse
Les points de terminaison qui renvoient des listes (comme /trips et /users) renvoient tous les enregistrements correspondants en une seule réponse — il n'y a pas de pagination. Pour les organisations disposant de grands volumes de données, cela peut entraîner des charges utiles très volumineuses.
Pour garder des tailles de réponse gérables :
Utilisez les paramètres de plage de dates disponibles pour délimiter votre requête (par exemple,
startDate/endDatesur le point de terminaison Trips)Évitez d'interroger sans filtres, sauf si une exportation complète des données est prévue
Codes de statut HTTP
Code | Signification |
| Succès |
| Requête incorrecte — vérifiez vos paramètres |
| Non autorisé — clé API manquante ou invalide |
| Interdit — votre forfait n'inclut pas l'accès à l'API |
| Ressource introuvable |
| Erreur serveur — réessayez après un court délai |
Points de terminaison disponibles
Point de terminaison | Description |
Lister et gérer les utilisateurs de votre organisation | |
Position en temps réel d'un utilisateur | |
Récupérer les enregistrements de trajets avec filtrage par utilisateur et par date | |
Obtenir les points de passage GPS d'un trajet spécifique | |
Gestion de l'approbation des trajets | |
Statistiques de kilométrage par utilisateur ou par période | |
Gestion des emplacements des utilisateurs | |
Enregistrements de véhicules de votre organisation | |
Enregistrements de dépenses | |
Gestion de l'approbation des dépenses | |
Images de reçus et métadonnées | |
Créer et gérer des balises personnalisées pour les trajets et les dépenses | |
Accéder au journal d'audit des enregistrements d'approbation | |
Enregistrements de suivi du temps par utilisateur et par plage de dates | |
Kilométrage réparti par État américain |
