Passerelle d'API

Guide produit : ce que la capacité apporte, pour qui, ses limites et la version qui l'a livrée - sans syntaxe de configuration.

Ce que ça fait	Sert les opérations déclarées dans un contrat OpenAPI 3.1 et les relaie vers leurs amonts. Une route non déclarée n'existe pas ; une opération sans amont empêche le démarrage. Les flux SSE et WebSocket sont relayés sans retenue. La configuration change sans redémarrage, et une configuration invalide ne remplace jamais celle qui tourne
Pourquoi c'est important	La documentation de l'API et ce que la passerelle sert ne peuvent plus diverger. Les erreurs suivent un format unique (RFC 9457) sur lequel un client aiguille sans lire de phrase. Les flux temps réel arrivent au rythme où ils sont produits, là où des passerelles du marché les livrent d'un bloc
Cas d'usage	Exposer une API publique ou partenaire ; remplacer une passerelle existante sans régression (la 1.0.0 l'a prouvé sur un produit réel qui quittait une autre passerelle) ; servir plusieurs API sur une passerelle, chacune sur son hôte ; relayer un tableau de bord en direct
Résilience	Délai par opération, reprises limitées aux requêtes rejouables, coupe-circuit par amont, cloisonnement, délestage quand la passerelle sature - et toute dégradation est annoncée au client, jamais silencieuse
Reprise de l'existant	La configuration d'une passerelle existante se convertit hors ligne, avec un rapport de ce qui est repris et de ce qui ne l'est pas (1.2.0)
Limites	Pas d'agrégation de plusieurs amonts en une réponse, pas de HTTP/3 côté appelant, pas de décodeurs XML ou formulaire (Ce qui n'est pas encore construit) ; ne sert pas de fichiers statiques
Depuis	0.1.0 (contrat), 0.2.0 (chemin de requête, flux), 0.1.0 (configuration vivante), 1.0.0 (délestage, première version qui promet la compatibilité)
Configurer	Servir sa première API, Reprendre une passerelle existante, Changer la configuration sans redémarrer