Configuración de solicitud

¿Qué es la configuración de la petición?

La configuración de la petición es donde defines los detalles del endpoint de API que quieres probar. Incluye la URL, el método HTTP y cualquier parámetro o encabezado adicional que requiera la petición.

Configurar la petición

1. URL del endpoint: Define la URL del endpoint de API que quieres probar. Es la dirección a la que la verificación enviará peticiones.
2. Métodos HTTP: Elige entre los siguientes métodos HTTP permitidos según lo que admita tu endpoint:

• GET: Obtener datos del servidor.
• POST: Enviar datos al servidor para crear o actualizar un recurso.
• PUT: Actualizar un recurso existente en el servidor.
• PATCH: Actualizar parcialmente un recurso existente en el servidor.
• DELETE: Eliminar un recurso del servidor.

Configuraciones adicionales de la petición

Puedes personalizar más tu verificación de API con las siguientes opciones:

• Parámetros de consulta (pestaña Parámetros, Agregar Parámetro de Consulta): Añade pares clave/valor para pasar datos adicionales por la URL. El cuadro de la URL y la lista se mantienen sincronizados: un par que añades aparece en la URL, y un parámetro que escribes en la URL aparece en la lista.

  • Ejemplo: https://api.example.com/resource?key1=value1&key2=value2

• Encabezados (pestaña Encabezados, Agregar Encabezado): Añade encabezados personalizados a tu petición. Los encabezados sirven para enviar metadatos y controlar cómo se procesa la petición.

  • Ejemplo: Content-Type: application/json

• Cuerpo POST (pestaña Cuerpo): Elige un tipo de cuerpo (none, JSON, form-data, GraphQL o raw) e introduce el cuerpo. Es útil para enviar datos que crean o actualizan recursos.

  • Ejemplo: {"name": "example", "value": "data"}

• Autenticación básica (pestaña Autenticación, Configurar Autenticación Básica): Introduce un nombre de usuario y una contraseña. Sirve para autenticar la petición con el servidor.

  • Ejemplo: Username: user, Password: pass

• Omitir SSL (pestaña Configuración): Opción para omitir la verificación SSL. Puede ser útil para probar endpoints con certificados autofirmados.

• Seguir redirecciones (pestaña Configuración): Opción para seguir las redirecciones HTTP. Así la verificación sigue cualquier respuesta de redirección del servidor.

Importar desde cURL

En lugar de rellenar la petición a mano, puedes pegar un comando cURL. Haz clic en Importar desde cURL, justo debajo del cuadro de la URL, pega el comando (por ejemplo, uno copiado de las herramientas de desarrollo de tu navegador con «Copiar como cURL» o de la documentación de tu API) y haz clic en Importar. LoadFocus rellena la URL, el método HTTP, los parámetros de consulta, las cabeceras, el cuerpo (JSON, codificado en URL o raw, con su cabecera Content-Type) y la autenticación básica a partir de -u, y activa Omitir SSL para -k y Seguir redirecciones para -L. Un comando con cuerpo pero sin método se importa como POST, tal como lo enviaría curl.

No se guarda nada hasta que hagas clic en Guardar: el panel muestra «Petición importada. Revisa las cabeceras y el cuerpo antes de guardar.» para que puedas revisar el resultado primero.

Algunas cosas se notifican en lugar de importarse: los campos de formulario multipart (-F), los cuerpos leídos de un archivo (@file), las opciones que la verificación no puede representar (la importación se completa igualmente y el panel enumera cada una), una segunda URL (solo se usa la primera) y una cabecera sin dos puntos o con salto de línea. Solo se pueden importar URL http y https, y un comando está limitado a 100 KB.

Casos de uso prácticos

• Probar peticiones GET: Comprueba que tu API obtiene los datos correctamente.
• Probar peticiones POST: Asegura que tu API puede manejar la creación o actualización de datos.
• Usar encabezados para la autenticación: Pasa tokens de autenticación en los encabezados para acceder a recursos protegidos.
• Enviar parámetros de consulta complejos: Prueba cómo maneja tu API las consultas complejas.

Con estos ajustes puedes adaptar tus verificaciones de API a los requisitos exactos de tu endpoint, para probar y monitorizar de forma completa.