Aller au contenu
Documentation TrakIT

Présentation de l'API

L’API de TrakIT permet à d’autres systèmes de travailler avec vos données TrakIT sans que personne ait à les saisir : créer des dossiers et mettre à jour des ordres de travail depuis vos propres systèmes, récupérer les factures et les factures fournisseurs dans votre logiciel comptable, permettre aux fournisseurs d’envoyer leurs factures, ou récupérer des rapports de façon planifiée.

Il existe deux API. Elles diffèrent par ceux qui les appellent et par la façon dont un appel est autorisé.

API Pour Autorisation
API d’intégration (/api/v1) Les propres systèmes de votre société. Un utilisateur TrakIT disposant de l’accès à l’API se connecte et envoie un jeton. Voir Jeton de connexion.
API publique (/api/public) Les partenaires : fournisseurs qui envoient leurs factures, clients qui suivent leurs conteneurs, systèmes qui récupèrent des rapports, systèmes de parc. Une clé d’API configurée pour ce partenaire. Voir Clés d’API.

API d’intégration

Section intitulée « API d’intégration »

L’API d’intégration lit et modifie les données TrakIT en tant qu’utilisateur TrakIT disposant de l’accès à l’API : un administrateur système pour lequel le support TrakIT a activé l’accès à l’API. Tout ce que fait l’intégration est enregistré au nom de cet utilisateur. Connectez-vous avec Login (et déconnectez le jeton avec Logout quand il n’est plus nécessaire), puis appelez :

API publique

Section intitulée « API publique »

Chaque point de terminaison public sert un type de partenaire, avec une clé qui n’autorise que ce point de terminaison :

URL de base

Section intitulée « URL de base »

L’API fait partie de votre installation TrakIT : son adresse est celle à laquelle vous vous connectez à TrakIT, suivie de /api/. Avec https://trakit.example.com comme exemple :

https://trakit.example.com/api/v1/GetJob
https://trakit.example.com/api/public/getbills

Appelez toujours l’API en HTTPS.

Requêtes

Section intitulée « Requêtes »
  • Un point de terminaison GET reçoit ses paramètres dans la chaîne de requête.
  • Un point de terminaison POST reçoit un corps JSON, envoyé avec Content-Type: application/json, sauf si sa page indique qu’il reçoit un fichier (multipart/form-data).
  • Les noms des points de terminaison et les paramètres de la chaîne de requête ne sont pas sensibles à la casse : /api/v1/getjob équivaut à /api/v1/GetJob. Pour les corps JSON, utilisez les noms de champs exactement comme la page de chaque point de terminaison les écrit : certains points de terminaison les lisent en respectant leur casse.
  • Toutes les réponses sont en JSON, sauf les fichiers de rapport que QueryReport et AdvReport peuvent renvoyer.

Réponses

Section intitulée « Réponses »

Les points de terminaison répondent avec le statut HTTP 200 et la même enveloppe JSON, que la requête ait réussi ou non :

{
  "Code": 1,
  "Info": "",
  "RetInfo": { },
  "RowsAffected": 0,
  "Scalar": null,
  "Identity": 0
}
Champ Signification
Code 1 quand la requête a réussi, 0 quand TrakIT l’a refusée, -1 quand une erreur l’a interrompue.
Info La raison du refus de la requête, ou l’erreur. Vide, ou une courte note, en cas de succès. Login y renvoie le jeton.
RetInfo Le résultat : un objet, une liste, ou null. La page de chaque point de terminaison le décrit.
RowsAffected Pour les listes, le nombre de lignes renvoyées. Certains points de terminaison l’utilisent pour le nombre d’enregistrements modifiés.
Scalar Une valeur unique, pour les quelques points de terminaison qui en renvoient une.
Identity L’identifiant de l’enregistrement créé ou modifié, pour les points de terminaison qui en créent ou en modifient un.

Vérifiez toujours Code avant de lire RetInfo. Quelques points de terminaison répondent autrement : avec un fichier, avec les données elles-mêmes au lieu de l’enveloppe, ou avec un statut d’erreur HTTP quand leur clé est absente. Leurs pages le précisent.

Dates et heures

Section intitulée « Dates et heures »
  • Envoi : écrivez les dates au format yyyy-MM-dd (2026-10-20) et les dates avec une heure au format yyyy-MM-ddTHH:mm:ss (2026-10-20T14:30:00). Certains points de terminaison lisent les dates selon les paramètres régionaux du serveur TrakIT : une date comme 10/11/2026 peut donc être lue comme le 10 novembre ou le 11 octobre. Les formats ci-dessus sont lus de la même façon partout.
  • Réception : les dates reviennent sous la même forme ISO 8601, 2026-10-20T14:30:00, avec les millisecondes quand elles ne sont pas nulles (2026-10-20T14:30:05.437). La plupart ne portent pas de fuseau horaire, même lorsqu’elles sont en UTC : la page de chaque point de terminaison indique si ses heures sont en UTC ou en heure locale.

Erreurs

Section intitulée « Erreurs »
Ce que vous obtenez Que faire
Code 0 La requête a été refusée : Info indique pourquoi, par exemple un champ manquant ou un enregistrement qui n’existe pas. Corrigez la requête et envoyez-la à nouveau. La page de chaque point de terminaison liste ses messages sous Règles.
Code -1 Une erreur a interrompu la requête. Envoyez-la à nouveau plus tard. Si l’échec persiste, contactez le support TrakIT en indiquant le point de terminaison, l’heure de l’appel et le texte de Info.
HTTP 404 L’adresse est incorrecte, ou un paramètre obligatoire de la chaîne de requête est absent : vérifiez la partie /api/v1/ ou /api/public/, le nom du point de terminaison et les paramètres.
HTTP 405 Le point de terminaison existe mais attend l’autre méthode : GET au lieu de POST, ou l’inverse.

Si un appel qui crée quelque chose expire et que vous ne savez pas s’il a abouti, vérifiez avant de l’envoyer à nouveau : par exemple, recherchez d’abord le dossier ou la facture fournisseur. L’envoyer deux fois peut créer l’élément deux fois, ou être refusé comme doublon.