Passer au contenu principal

Aperçu de l'API des services Web

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/json pour les requêtes POST avec un corps de requête

  • Format 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 / endDate sur 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

200

Succès

400

Requête incorrecte — vérifiez vos paramètres

401

Non autorisé — clé API manquante ou invalide

403

Interdit — votre forfait n'inclut pas l'accès à l'API

404

Ressource introuvable

500

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

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