Une API n’est rien d’autre qu’une manière convenue pour deux programmes de se parler. Au lieu qu’un collaborateur saisisse un VIN dans un formulaire, lise le résultat et le reporte dans la gestion, la gestion interroge elle-même et écrit la réponse dans ses propres champs.
Ce qui change réellement
| Opération | Sans API | Avec API |
|---|---|---|
| Créer un véhicule | Saisir le VIN, lire, reporter | Scanner le VIN, les champs sont remplis |
| Saisir une pièce | Chercher la référence, choisir le type, estimer les dimensions | Référence issue de l’image, type et attributs du recoupement |
| Diffuser une annonce | Ressaisir par canal | Une fiche, plusieurs canaux |
| Source d’erreur | Chaque report manuel | Aucun report manuel |
Le gain tient moins à la minute économisée qu’aux erreurs évitées. Un chiffre mal recopié dans une référence produit un retour, et un retour coûte plusieurs fois le temps gagné.
À partir de quand c’est rentable
Réponse honnête : pas tout de suite. Tant qu’un centre reçoit peu de véhicules par mois et que la saisie se fait au fil de l’eau, l’interface web reste plus rapide. Le basculement survient quand le même geste devient routinier — en général plusieurs opérations par jour, ou l’ajout d’un second canal de vente qui imposerait une double saisie.
À quoi ressemble un appel
Techniquement, c’est un appel HTTP ordinaire avec une clé dans l’en-tête. Un exemple tiré de la documentation :
curl \ -H 'X-Api-Key: <API_KEY>' \ 'https://api.tapinomahub.com/parts/oe/5Q0919275C'
La réponse est structurée et lisible par machine. Tout logiciel parlant HTTP — c’est-à-dire tous — peut l’exploiter. La description complète des points d’entrée figure dans la documentation, liée depuis la page API. Quels appels s’appliquent à quelle catégorie de logiciel — ERP, DMS, flotte, atelier, marketplace — est décrit sur les pages d’intégration.
Le déroulé habituel d’une connexion
- Créer un compte et générer une clé. La clé va dans la configuration du logiciel, pas dans le code source ni dans un fichier partagé par mégarde.
- Choisir une opération. Ne pas tout connecter d’un coup. L’import véhicule par le VIN est presque toujours le premier pas le plus rentable.
- Définir la correspondance des champs. Quels champs de la réponse vont dans quels champs de votre gestion ? C’est là le vrai travail, pas l’appel.
- Tester sur quelques véhicules. Y compris les cas limites : aucun résultat, demi-résultat, numéro invalide.
- Définir le cas d’échec. Que se passe-t-il sans réponse ? Règle saine : créer l’enregistrement, laisser le champ vide, générer une tâche — jamais une valeur estimée.
- Déployer et observer. Au bout de deux semaines, le journal montre quelles opérations tournent et à quelle fréquence.
Points de vigilance
- Ne pas combler les champs vides. Si une source ne donne rien, le champ reste vide et une tâche est créée — ni valeur par défaut ni estimation. Une valeur plausible dans un stock est plus dangereuse qu’un manque visible.
- Penser à l’idempotence. Un import lancé deux fois ne doit pas créer un second véhicule. Le VIN est la clé naturelle.
- Ne pas interroger à chaque affichage. Les résultats vont dans votre base ; chaque requête coûte.
- Protéger la clé. Une clé dans un fichier posé sur un partage réseau n’est plus une clé.
- Rendre la provenance visible. Si la fiche indique quel champ vient d’une requête et lequel a été tapé, les écarts ultérieurs s’expliquent.
Questions fréquentes
Faut-il un développeur ?
Pas nécessairement. Beaucoup de logiciels se connectent par leur éditeur. Pour un développement propre, des bases HTTP suffisent.
L’usage via API coûte-t-il plus cher ?
Non. Ce sont les mêmes requêtes aux mêmes tarifs, émises par un autre programme.
Que faire si l’API ne répond pas ?
Votre système doit créer l’enregistrement, laisser le champ vide et générer une reprise. Une valeur par défaut serait pire qu’un manque.
Puis-je commencer par l’interface web ?
Oui, et c’est souvent la bonne voie. La connexion se justifie quand le même geste revient plusieurs fois par jour.