Api2api Se connecter Essayer gratuitement
Fonctionnalités

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.

1 — Découverte

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.

2 — Conversion

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.

3 — Correspondances

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.

4 — Exploitation

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