Ir al contenido

Simular una API HTTP

Clic derecho sobre una carpeta ▸ Añadir ▸ Servidor HTTP.

Un servidor se configura con los mismos campos que una petición, y ahí está todo el interés: el método y la ruta definen la ruta escuchada, y el estado, las cabeceras y el cuerpo definen la respuesta servida.

CampoFunción
MétodoEl método de la ruta
Direcciónlocalhost:<puerto><ruta> — el host está fijado
Estado de simulaciónEl código devuelto, 200 por defecto
CabecerasLas cabeceras de la respuesta
CuerpoEl cuerpo de la respuesta

Un elemento Servidor HTTP: la URL reducida a localhost + puerto + ruta, el método servido, las cabeceras y el cuerpo de la respuesta simulada

Una ruta es un par método + ruta. El emparejamiento se hace sobre la ruta exacta, y la cadena de consulta se ignora. Toda llamada que llegue al puerto sin corresponder a una ruta recibe un 404.

Dos rutas solo entran en colisión si comparten el mismo método, la misma ruta y el mismo puerto. Puede, por tanto, crear una petición de servidor por ruta e iniciarlas todas.

GET localhost:8080/clients → 200, liste de clients
GET localhost:8080/clients/42 → 200, un client
POST localhost:8080/clients → 201, en-tête Location
GET localhost:8080/clients/999 → 404 (aucune route : réponse par défaut)

Las cabeceras y el cuerpo se resuelven en cada llamada entrante. Un cuerpo que contenga {{maintenant}} o {{compteur}} cambia, por tanto, de una llamada a otra si la variable cambia.

Consejo: esto permite dirigir el comportamiento del servidor mientras está en marcha: cambie el valor de una variable de entorno y la llamada siguiente recibirá una respuesta distinta, sin reiniciar.

Un servidor HTTP de simulación y un servidor WebSocket o Socket.IO pueden escuchar en el mismo puerto: Restorm encamina las peticiones ordinarias hacia las rutas HTTP y las solicitudes de cambio de protocolo hacia el servidor en tiempo real.

La acción Servidor HTTP aloja la ruta durante el tiempo que dura el escenario y emite un evento served —que lleva { request, response }por cada llamada recibida. Es la forma de probar un webhook:

Serveur HTTP ──connected──► Requête HTTP « déclencher le webhook »
└────────served──────► Assert sur request.body
puis ──► Fermeture serveur HTTP

Consulte Servidores alojados.