Cloud/Créer un Connecteur/OpenAPI / Swagger
OpenAPI / Swagger
Le troisième parcours de Create Connector : connectez votre API avec une seule URL. Vinkius découvre vos endpoints et les transforme en outils utilisables par les agents IA, avec les annotations mappées automatiquement.
OpenAPI / Swagger est le troisième parcours au sein de Create Connector, et c'est le plus rapide quand votre API existe déjà. La carte de la console le dit en une phrase : "Connect your API with one URL. Vinkius discovers your endpoints and turns them into tools AI agents can use." Les deux tags nomment le bénéfice : Auto-generates tools et AI-ready annotations. Vous ne décrivez pas votre API, vous pointez simplement vers elle.
Deploy Connector
Connect your API to AI agents in under 30 seconds.
Auto-discovers and generates all tools for your AI agents instantly.
Auto-detected from the OpenAPI spec if left empty.
Le mockup est le vrai wizard. Collez une URL de spec et regardez la détection : le nombre d'endpoints arrive en émeraude pendant que le nom et la base URL se remplissent tout seuls. Continuez par Security et Governance, puis déployez.
Une URL. Tous les outils.
Le panneau pédagogique énonce l'offre : "Paste your spec URL and we do the rest: endpoints discovered, tools generated, annotations mapped. AI agents can use them instantly." Les petits caractères sont généreux : OpenAPI 2.0, 3.0, 3.1. JSON ou YAML. On s'en occupe.
La première étape demande l'OpenAPI / Swagger URL. Pendant que vous tapez, la console inspecte la spec : un spinner bleu "Detecting..." tourne, puis une ligne émeraude annonce le résultat, "{count} endpoints ready for AI". Une spec qui ne résout reçoit le rouge "Invalid spec URL. Make sure it points to a valid OpenAPI/Swagger file." Avant que quoi que ce soit soit collé, le champ s'explique : "Auto-discovers and generates all tools for your AI agents instantly."
Le reste du formulaire se remplit tout seul
La détection ne s'arrête pas au nombre d'endpoints. Le Server Name se remplit depuis le titre de la spec, et son placeholder bascule vers "Auto-detected ✓". La Base URL est optionnelle parce qu'elle est "Auto-detected from the OpenAPI spec if left empty." Vous pouvez écraser les deux ; le fait est que vous n'y êtes généralement pas obligé.
Security : les identifiants ne quittent jamais le vault
La deuxième étape demande comment votre API s'authentifie. Les options de Auth Type sont None · Public API, Bearer Token, Basic Auth (user:password) et Custom Header (avec son nom et sa valeur de header). Si la spec elle-même déclare un schéma de sécurité, un bandeau bleu le signale : "Security detected in spec: Bearer Token. Select below if your API requires it." Tout ce que vous saisissez porte une promesse, écrite en émeraude sur le formulaire : "AES-256 encrypted at rest. Credentials never leave your vault." Les clés sont chiffrées au repos, injectées au runtime et invisibles pour le modèle ; les agents appellent votre API via Vinkius, jamais avec vos secrets dans leur contexte.
Governance : protégez ce qui compte
La troisième étape propose deux commutateurs, tous deux optionnels et tous deux modifiables plus tard depuis les settings :
- Zero-Trust PII Redaction : "Masks emails, SSNs, and credit cards in RAM before returning data to the AI. GDPR-compliant by default."
- Smart Array Truncation, badgé Cost Control : "Large arrays shrink automatically. Same data, fewer tokens. Your context window stays focused."
Ce sont les mêmes politiques que vous pouvez gérer par connecteur plus tard dans DLP Protection et FinOps Guard ; cette étape fixe simplement les défauts à la naissance.
Le deploy et ce qui en sort
Deploy to Edge exécute les phases du mode swagger : l'analyse des specs OpenAPI, le scellement du V8 Isolate Sandbox, l'injection du Zero-Trust DLP, la distribution vers le edge mondial. Puis votre connecteur is Live! avec son Connection Token à usage unique et le config JSON mcpServers prêt à copier ou télécharger, avec un onglet par client : Claude, Cursor, VS Code, Antigravity et Others. De là, il se comporte comme tout connecteur : Dashboard pour le surveiller, AI Capabilities pour revoir les outils générés par la spec, Playground pour les exécuter.
Pourquoi ce parcours existe
Des milliers d'API parlent déjà OpenAPI. Ce parcours transforme cette description existante en AI Capabilities sans écrire une seule ligne de code d'intégration : une URL entre, chaque endpoint sort comme un outil qu'un agent peut appeler, annoté et gouverné dès la première requête.
Et ensuite
Le dernier parcours de Create Connector a son propre guide : Manual Setup (pas de spec ? ajoutez votre API à la main, étape par étape). Après les parcours, le Seller Account de la console couvre la mise en vente sur le marketplace.