Puesta en marcha rápida (5 minutos)
Objetivo: partir de una instalación nueva y llegar a una petición autenticada cuya URL y token provienen de variables. Cuente unos cinco minutos.
1. Crear un proyecto
Section titled “1. Crear un proyecto”Archivo ▸ Nuevo (Ctrl+N) y luego Archivo ▸ Guardar como
(Ctrl+Shift+S) para darle un nombre, por ejemplo demo.restorm.
Un proyecto es un simple archivo en su disco. Puede colocarlo en un repositorio git desde este mismo momento: Restorm está hecho para eso.
2. Crear una carpeta de variables
Section titled “2. Crear una carpeta de variables”Clic derecho en el árbol lateral ▸ Añadir ▸ Carpeta de variables.
Una carpeta de variables (o carpeta de entorno) es el contenedor que aloja
sus entornos —local, staging, production— y, por tanto, sus
{{variables}}. Todas las peticiones que contiene heredan el entorno
seleccionado.
Ábrala, cree un entorno local y añada una variable:
| Clave | Tipo | Valor |
|---|---|---|
baseUrl | Cadena | https://api.exemple.test |
3. Crear y enviar una petición
Section titled “3. Crear y enviar una petición”Clic derecho sobre la carpeta ▸ Añadir ▸ Petición HTTP. En la pestaña que se abre:
- deje el método en
GET; - escriba la URL
{{baseUrl}}/health— el valor resuelto aparece debajo del campo, es su red de seguridad; - haga clic en Send.
La respuesta se abre debajo: estado, tiempo, tamaño, cabeceras y el cuerpo representado en un visor JSON plegable.
4. Añadir la autenticación
Section titled “4. Añadir la autenticación”En lugar de pegar un token fijo, cree una petición de autenticación: clic
derecho ▸ Añadir ▸ Petición de autenticación. Configure la llamada que obtiene
el token (por ejemplo un POST /oauth/token) y luego, en su pestaña
Configuración, declare lo que produce:
| Cabecera producida | Valor |
|---|---|
Authorization | {{token_type}} {{access_token}} |
El valor es una expresión evaluada sobre el cuerpo de la respuesta de la
petición de autenticación. Aproveche para indicar la expresión de caducidad (por
ejemplo {{expires_in}}) y que Restorm renueve el token por sí solo.
Vuelva a su petición GET y, en la barra superior, elija esa ruta de
autenticación. La cabecera se inyecta ahora en cada envío, y un 401 desencadena
automáticamente una renovación seguida de un reintento.
Más detalles: Autenticación.
5. Ir más lejos
Section titled “5. Ir más lejos”- ¿Ya tiene una especificación o una colección? Archivo ▸ Importar
(
Ctrl+I) reconstruye el árbol completo: consulte Importación y exportación. - Encadene varias llamadas y compruebe los resultados con un escenario.
- Ejecute ese escenario en su CI: Ejecución headless.