Ce que fait la passerelle, en détail
Quatre sujets, dans l'ordre où on les rencontre : reconnaître une API, faire parler deux formats incompatibles, relier les champs, et tenir le volume dans la durée.
Reconnaître une API à partir de ce qu'elle publie
Vous donnez un point de départ : une page de documentation, un lien de spécification, ou l'API elle-même. Le serveur s'y rend et cherche, dans cet ordre, ce qui coûte le moins cher et rapporte le plus.
Les descriptions publiées
OpenAPI et Swagger (JSON comme YAML), WSDL pour les services SOAP, schéma GraphQL par introspection. Quand elles existent, tout est exact : chaque route, chaque champ, chaque type.
Les portails de documentation
Il n'existe pas mille façons de publier une documentation d'API : il en existe une quinzaine, et chacune range sa spécification à un endroit connu. Ces plateformes sont reconnues et leur fichier récupéré directement.
Les pages écrites pour des humains
Un wiki, un README, une page « téléchargez la spécification ». Les tableaux de routes, les exemples de requêtes et jusqu'à la prose sont lus. Y compris les pages construites en JavaScript, dont le texte servi est presque vide.
Un fichier que vous déposez
C'est le cas des API internes : pas de portail, mais un document. PDF, Word, Excel, CSV, Markdown, archive — vous le déposez, les routes et les champs en sont extraits.
Les API protégées
Une clé d'accès suffit à ouvrir une documentation fermée. Elle n'est envoyée qu'au domaine concerné — jamais aux liens externes rencontrés en chemin, ni aux scripts chargés depuis un CDN.
La saisie à la main
Rien n'oblige à passer par la découverte. Une route, une méthode, des champs : vous les saisissez, et le flux fonctionne exactement pareil.
Ce que la découverte ne fait pas
Elle ne devine pas ce qui n'est écrit nulle part. Une API sans documentation, sans spécification et sans exemple ne rendra rien — et le dira, en détaillant ce qui a été tenté, plutôt que de vous laisser avec un catalogue vide. Elle respecte aussi le rythme des serveurs qu'elle interroge : une requête par seconde et par hôte, avec un plafond par analyse.
SOAP d'un côté, REST de l'autre
C'est le travail ingrat que tout le monde refait à chaque projet : envelopper, désenvelopper, traduire les types, adapter l'authentification. Il est fait au passage, dans les deux sens.
Les enveloppes
Une réponse SOAP arrive enveloppée dans du XML ; l'API d'arrivée attend du JSON plat. La traduction se fait sans que vous ayez à la décrire, et dans l'autre sens aussi.
Les types
Un nombre écrit en texte, une date au format américain, un booléen envoyé comme
"0", une liste là où l'autre attend une valeur seule : ces écarts sont
convertis au moment du transfert.
Les authentifications
Jeton porteur, clé en en-tête, clé dans l'URL, authentification de base. Les secrets sont chiffrés au repos, ne sont jamais réaffichés une fois enregistrés, et n'apparaissent dans aucun journal.
Relier les champs, à l'écran
Les champs de départ à gauche, ceux d'arrivée à droite. Un clic sur l'un, un clic sur
l'autre. Les champs imbriqués sont dépliés — client.adresse.ville se relie
aussi simplement qu'un champ de premier niveau.
Voir la donnée reçue
Avant de relier quoi que ce soit, vous pouvez déclencher un appel et regarder ce que l'API renvoie vraiment. Une documentation dit ce qui devrait arriver ; ça, c'est ce qui arrive.
Deux déclencheurs
Sur envoi entrant, quand la source sait pousser ses données ; ou par interrogation régulière, à l'intervalle que vous choisissez, quand elle ne sait pas.
Une cartographie
Un écran montre qui parle à qui : quelles API, par quels flux, dans quel sens. C'est ce qu'on regarde le jour où il faut expliquer le système à quelqu'un — ou le débrancher sans rien casser.
Tenir le volume, et savoir ce qui se passe
Une file d'attente, pas un tuyau
Chaque donnée entrante est acceptée puis mise en file. Les transferts sont exécutés par des travailleurs séparés de l'interface : une API d'arrivée qui met vingt secondes à répondre ne ralentit jamais votre écran.
Rien ne se perd sur une panne
Un échec est réessayé, avec un espacement croissant. Ce qui échoue durablement reste visible, avec la donnée exacte qui a posé problème — et peut être renvoyé d'un clic une fois le problème réglé.
Ça monte en charge
Plusieurs travailleurs peuvent tourner en parallèle sans se marcher dessus ni traiter deux fois la même donnée : la file les répartit d'elle-même.
Le journal
Chaque transfert est enregistré : ce qui est parti, ce qui a été reçu, ce que l'API d'arrivée a répondu. La profondeur consultable dépend de la formule.
Le cloisonnement
Chaque organisation ne voit que ses données, et cette règle est appliquée au niveau de la base : une requête qui ne porte pas l'organisation courante est refusée par le serveur lui-même, pas par une condition qu'un développeur aurait pu oublier d'écrire.
Vos API privées le restent
Une API ajoutée à votre catalogue n'est visible que de votre organisation. Ses routes ne sont publiées nulle part et ne sont partagées que si vous cochez explicitement la case qui le demande.
Le meilleur moyen de savoir si ça marche chez vous
C'est de brancher une de vos API et de regarder ce que la découverte en fait. Ça prend quelques minutes, et ça répond mieux que n'importe quelle page.
Essayer gratuitement