Ir al contenido

Solicitudes y el formato .http

Cada solicitud es un único archivo .http que usa sintaxis HTTP estándar más un pequeño conjunto de extensiones prefijadas con comentarios. Como el formato es texto plano, el mismo archivo se lee desde cualquier editor y se revisa en un diff.

# @id 9e3a4f72-1234-4abc-9def-0123456789ab
# @rawSubtype: json
# @pre-request-script
# fp.environment.set('token', 'abc')
# @end-script
# @settings
# httpVersion: auto
# verifySsl: true
# followRedirects: true
# maxRedirects: 5
# @end-settings
POST {{baseUrl}}/api/users
Content-Type: application/json
{ "name": "Juan" }

Elementos clave:

  • Placeholders {{variable}} en la URL, las cabeceras, el body y los campos de formulario se resuelven contra el entorno activo combinado con las mutaciones de script en curso.
  • ### es el separador de solicitudes, pero Fetchpier mantiene una solicitud por archivo: si un archivo tiene varias, abre y ejecuta solo la primera. Ver Compatibilidad con otras herramientas .http.
  • # @id <uuid> identifica la solicitud con un UUID estable entre renombres, así los registros de historial siguen apuntando al origen correcto aunque muevas el archivo.
  • # @rawSubtype: declara el subtipo del body (json, xml, javascript, text, html) para el resaltado de sintaxis y los defaults de Content-Type.
  • # @pre-request-script … # @end-script y # @post-response-script … # @end-script llevan los scripts del usuario como líneas prefijadas con comentarios, así el archivo sigue siendo .http válido.
  • # @settings … # @end-settings lleva overrides HTTP por solicitud.
  • # @disable-cookie-jar marca una solicitud que debe saltear el cookie jar en este envío.
  • # @auth … # @end-auth persiste el esquema de autenticación de la solicitud (tipo y mapeo de campos) para que sobreviva un guardar / reabrir. El esquema activo además se materializa en la solicitud ejecutable como una cabecera estándar —o un parámetro de query inicial— así el archivo sigue enviando la auth al abrirse en otra herramienta .http; None no escribe ni bloque ni entrada materializada. Un bloque malformado, incluido uno al que le falte la línea de cierre, se reporta y se ignora, y la solicitud igual carga y sigue siendo ejecutable, sin auth.

Para la referencia completa de sintaxis, mirá Formato .http.