Constructor de peticiones HTTP — componga y genere cURL / Node / Python / PowerShell
Constructor de peticiones HTTP
Componga una petición HTTP paso a paso — variables de ruta como {userId}, parámetros de consulta, cabeceras, cuerpos JSON o de formulario y autenticación — y genere código listo para ejecutar en cURL, Node.js fetch, Python requests o PowerShell. Esta herramienta sirve para diseñar y generar; para enviar realmente una petición e inspeccionar la respuesta en vivo, pase la petición con el botón Probar petición → (abre el Cliente / probador de API REST), o convierta un cURL pegado con el Conversor de comandos cURL. Todo se compone en local en su navegador. Esta página nunca envía ninguna petición.
Parámetros de ruta ({name} tokens en la URL de arriba)
Parámetros de consulta
Cabeceras
Cuerpo
Autorización
Vista previa de cURL en directo: se actualiza mientras escribe:
cURLNode.js fetchPython requestsPowerShell
Consejos: encierre un segmento de la URL entre llaves ({userId}) para gestionarlo como parámetro de ruta; el código generado se actualiza en cada cambio. Las peticiones GET y HEAD ignoran el cuerpo. Las subidas de archivos generadas usan el estilo @archivo de cURL o marcadores en otros lenguajes — adjunte archivos reales en su propio código. El envío de origen cruzado lo cubre el Cliente de API REST (respete la política CORS del servidor); para invertir un comando existente use el Conversor de comandos cURL.
Métodos HTTP explicados
Al elegir un método, el código generado para cURL / Node / Python / PowerShell cambia para ajustarse. Esto es lo que significa cada verbo para la petición que está construyendo:
GET — Recupera una representación de un recurso. No debería cambiar el estado del servidor, y la petición generada normalmente no tiene cuerpo. Use GET para lecturas, búsquedas y endpoints de listado.
POST — Envía datos para crear un recurso nuevo o desencadenar una acción. El cuerpo se convierte en la carga útil del código generado (--data-raw en cURL, un argumento de cuerpo en Node o Python, etc.). POST no es idempotente: enviarlo dos veces puede crear dos recursos.
PUT — Sustituye por completo un recurso existente. Envíe el objeto completo en el cuerpo; los campos omitidos pueden tratarse como vacíos. El código generado envía el cuerpo entero a la URL exacta.
PATCH — Actualiza solo los campos que incluya. El cuerpo lleva un conjunto parcial de cambios, así que las peticiones generadas son más pequeñas que con PUT cuando solo edita uno o dos valores.
DELETE — Elimina el recurso de la URL. Es idempotente y normalmente no tiene cuerpo, así que el código generado es una llamada de borrado sencilla con solo cabeceras.
HEAD — Pide solo las cabeceras, sin cuerpo de respuesta. El código generado parece un GET, pero devuelve metadatos como Content-Length, Last-Modified o Content-Type, lo que ahorra ancho de banda.
OPTIONS — Descubre qué permite el servidor para una URL, o simula una comprobación previa de CORS. Las cabeceras de respuesta (por ejemplo Access-Control-Allow-Methods) muestran los verbos permitidos. OPTIONS normalmente no tiene cuerpo de petición.
Fácil de confundir:HEAD frente a GET — las peticiones generadas son parecidas, pero HEAD no devuelve cuerpo. PUT frente a PATCH — PUT reescribe el recurso completo; PATCH cambia solo los campos que usted proporciona.
🔷 Herramientas de API
Pruebe y construya peticiones HTTP y WebSocket, convierta cURL y explore especificaciones OpenAPI.