Ir al contenido

El diseñador de API

El diseñador de API le permite diseñar una API completa directamente en Restorm: usted describe sus datos y sus rutas, y Restorm se encarga del resto — sirve su diseño como un verdadero servidor mock, y genera el código de su aplicación a partir de plantillas.

Es la herramienta ideal para arrancar una API antes de que exista el back-end: maquete el contrato, hágalo probar a sus clientes y mantenga todo versionado en su proyecto.

Visión general del diseñador de API: la barra lateral lista los modelos, enums, rutas, el servidor, los clientes y el código

Un diseño se crea como cualquier otro elemento: clic derecho en una carpeta ▸ Añadir ▸ Diseño de API. Se abre en su propia pestaña y agrupa varias secciones, accesibles desde la barra lateral:

SecciónPara qué sirve
ModelosSus entidades y sus propiedades — véase Modelos, enums y propiedades.
EnumsConjuntos de valores cerrados, reutilizables como tipo de propiedad.
RutasLos puntos de entrada de la API, agrupados por recurso — véase Rutas y CRUD.
ServidorServir el diseño como un mock, en HTTP, GraphQL, SOAP, OData o gRPC — véase Servir el diseño como mock.
ClientesPeticiones listas para usar que llaman al mock en ejecución — véase Clientes.
Documentación y NotasDocumentación y notas libres adjuntas al diseño.
CódigoLa generación de código a partir de sus plantillas — véase Generación de código.

Los ajustes del diseño (nombre, valores por defecto) se abren haciendo clic directamente en el nodo del diseño en la barra lateral.

  1. Describa sus datos — cree sus modelos y sus enums, añada sus propiedades, sus tipos y sus restricciones.
  2. Defina sus rutas — a mano, o con un clic mediante Generar el CRUD desde un modelo.
  3. Sirva el mock — inicie el servidor y apunte su aplicación o un cliente hacia él. El mismo diseño se proyecta automáticamente en cada protocolo activado.
  4. Genere el código — elija una o varias plantillas (las suyas o las propuestas por Restorm) y produzca el proyecto correspondiente.

Cada paso se detalla en las páginas de esta sección.