Importer un document AsyncAPI

AsyncAPI décrit les API pilotées par les événements comme OpenAPI décrit les API REST. Restorm en tire des requêtes de messagerie.

Importer

Fichier ▸ Importer (Ctrl+I) puis le document, en YAML ou en JSON.

Ce qui est importé

Élément	Ce que Restorm en fait
Chaque canal	Une requête de publication et une requête d’abonnement, étiquetées comme telles
Le protocole du serveur	Le type de la requête produite (voir ci-dessous)
Le schéma des messages	Une charge d’exemple construite d’après le schéma
Descriptions	La documentation d’API

Les requêtes sont regroupées dans un dossier par protocole.

Correspondance des protocoles

Protocole AsyncAPI	Requête Restorm produite
mqtt, mqtts	MQTT, avec un préfixe d’URL mqtt://
socketio, socket.io	Socket.IO
Tout le reste	WebSocket, avec un préfixe d’URL ws://

Kafka et AMQP

Les liaisons AsyncAPI Kafka et AMQP ne produisent pas de requêtes Kafka ou AMQP : elles tombent dans la catégorie « tout le reste » et donnent des requêtes WebSocket. Créez ces requêtes à la main après l’import — la structure des canaux importée vous donne les sujets et les files à reprendre.

Mettre à jour

AsyncAPI fait partie des formats re-synchronisables. Voir Mettre à jour depuis la source.