Aller au contenu

Le designer d'API

Le designer d’API vous laisse concevoir une API complète directement dans Restorm : vous décrivez vos données et vos routes, Restorm s’occupe du reste — il sert votre design comme un vrai serveur mock, et il génère le code de votre application à partir de modèles.

C’est l’outil idéal pour démarrer une API avant que le back-end n’existe : maquettez le contrat, faites-le tester à vos clients, et gardez le tout versionné dans votre projet.

Vue d'ensemble du designer d'API : la barre latérale liste les modèles, enums, routes, le serveur, les clients et le code

Un design se crée comme n’importe quel élément : clic droit sur un dossier ▸ Ajouter ▸ Design d’API. Il s’ouvre dans son propre onglet et regroupe plusieurs sections, accessibles depuis la barre latérale :

SectionÀ quoi elle sert
ModèlesVos entités et leurs propriétés — voir Modèles, enums et propriétés.
EnumsDes ensembles de valeurs fermés, réutilisables comme type de propriété.
RoutesLes points d’entrée de l’API, regroupés par ressource — voir Routes & CRUD.
ServeurServir le design comme un mock, en HTTP, GraphQL, SOAP, OData ou gRPC — voir Servir le design en mock.
ClientsDes requêtes prêtes à l’emploi qui appellent le mock en cours d’exécution — voir Clients.
Documentation & NotesDe la documentation et des notes libres attachées au design.
CodeLa génération de code à partir de vos templates — voir Génération de code.

Les réglages du design (nom, valeurs par défaut) s’ouvrent en cliquant directement sur le nœud du design dans la barre latérale.

  1. Décrivez vos données — créez vos modèles et vos enums, ajoutez leurs propriétés, leurs types et leurs contraintes.
  2. Définissez vos routes — à la main, ou d’un clic avec Générer le CRUD depuis un modèle.
  3. Servez le mock — démarrez le serveur et pointez votre application ou un client dessus. Le même design est projeté automatiquement dans chaque protocole activé.
  4. Générez le code — choisissez un ou plusieurs templates (les vôtres ou ceux proposés par Restorm) et produisez le projet correspondant.

Chaque étape est détaillée dans les pages de cette section.