Décrivez un service distant, cessez de le coder
L'URL, le protocole, le mode d'authentification et la durée de vie des jetons tiennent dans une fiche. Ce qui restait du développement spécifique devient un paramétrage qu'on relit.
Brancher un service extérieur
Au cas par cas
- Chaque service demande son module, écrit pour lui seul.
- Le renouvellement des jetons est réécrit à chaque fois, et c'est toujours là que ça casse : un jeton expiré, et le flux s'arrête sans prévenir.
- Quand un appel échoue, il faut rouvrir le code pour savoir ce qui est parti.
Avec Universal API
- Le service est une fiche.
- L'authentification est un choix dans une liste : jeton direct, identifiants, en-tête, et le renouvellement suit la durée de vie que vous déclarez.
- Chaque appel laisse sa trace : ce qui est parti, ce qui est revenu, en combien de temps.
Cessez d'écrire un module par fournisseur
Relisez le branchement six mois plus tard
Six mois plus tard, on ouvre la fiche et on voit comment le service est joint. Pas besoin de retrouver qui avait écrit le module, ni pourquoi.
Oubliez les jetons expirés
Durée de vie déclarée, renouvellement automatique, historique conservé si vous le demandez. Le cas qui casse le plus souvent est traité une fois pour toutes.
Diagnostiquez un incident sans rouvrir le code
Le code HTTP, la durée et la réponse complète sont conservés. La question « qu'est-ce qui est parti ? » a une réponse, sans rouvrir le code.
Décrivez le service une fois, servez-vous-en partout
URL, protocole, type de contenu, environnement et mode d'authentification tiennent sur une fiche. C'est la même pour un service public gratuit et pour l'API d'un fournisseur qui exige un jeton renouvelé toutes les heures.
- REST, RPC, SOAP ou JSON-RPC : le SOAP passe par son WSDL, et le JSON-RPC parle à un autre Odoo.
- JSON ou XML, jusqu'aux formats de mise à jour partielle.
- En-tête d'authentification au choix : Authorization, x-api-key ou le vôtre, avec ou sans préfixe.
- Secret hors base : le jeton peut être lu dans l'environnement du serveur au lieu d'être stocké.
- Quatre environnements sur la même description : production, test, pré-production, développement.
- Vérification SSL débrayable, pour un service interne à certificat maison.
Retrouvez ce qui est parti, et ce qui est revenu
Ce qui est parti, ce qui est revenu, le code HTTP et la durée. La réponse est conservée telle quelle et se déplie dans une visionneuse, sans quitter Odoo.
- Réponse conservée en entier, dépliable dans une visionneuse, pas seulement un résumé.
- Durée en millisecondes : une lenteur se constate au lieu de se discuter.
- Historique des jetons, si vous demandez à le garder.
- Les échecs sont conservés au même titre que les réussites : c'est là qu'on cherche.
Branchez ce que vous avez déjà
Complétez une fiche client depuis le registre
L'API « Recherche d'entreprises » de l'État est gratuite et ne demande aucune clé. Une recherche par nom ou par SIREN rend l'adresse, le SIRET et l'activité.
- Aucun compte, aucun crédit à acheter.
- Champs sélectionnés : vous décidez ce qui revient, plutôt que de recevoir toute la fiche.
- La réponse alimente directement une fiche contact.
Interrogez catalogues et disponibilités
Un fournisseur qui expose une API impose son mode d'authentification et ses limites d'appel. Les deux se déclarent sur la fiche.
- Durée de vie déclarée : le jeton se renouvelle avant d'expirer, pas après.
- Le nombre de résultats par page est un paramètre, pas une constante enfouie dans du code.
- Chaque appel garde sa trace, ce qui rend une réclamation vérifiable.
Reliez votre logiciel maison sans le toucher
Un logiciel maison, un entrepôt de données, une application métier : s'il expose une API, il se décrit comme les autres.
- Rien à installer côté service.
- Points d'entrée typés : authentification, contrôle de jeton et objet, chacun avec son chemin.
- L'appel peut être déclenché par une action ou par une tâche planifiée.
Reliez-le au reste de votre Odoo
Une fois le service décrit, l'appel se range dans un connecteur, et sa réponse peut alimenter n'importe quel modèle d'Odoo.
- Universal Connector
- Universal Data Tool
- Contacts
- Ventes
- Achats
- Stock
Avant de brancher un service
Dites-nous quel service vous voulez brancher
Dites-nous lequel. Nous regardons ensemble ce que sa description demande, et ce qu'elle évite d'écrire.