Ir al contenido
↑↓ moverse↵ abriresc cerrar

Enviar requests

Requests HTTP

Envía tu primer request HTTP con un GET y un POST contra una API pública, y aprende los métodos, la barra de la URL y cómo leer la respuesta.

4 min de lectura

Un request HTTP es el request de todos los días: una llamada a una API REST con un método y una URL. Sigue los dos ejemplos de abajo para enviar uno tú mismo en pocos minutos. No necesitas una cuenta ni un contrato.

JSONPlaceholder es una API gratuita para practicar. Este request lee el post número 1.

  1. En la barra lateral, abre tu colección y haz clic en Nuevo request. Se abre el diálogo Nuevo request.
  2. Elige HTTP. Se abre en su propia pestaña un request llamado Nuevo request, con el método GET.
  3. Haz clic en el campo de la URL y escribe https://jsonplaceholder.typicode.com/posts/1.
  4. Pulsa Enviar (⌘/Ctrl + Enter). La respuesta se abre debajo del request.

Un request con su método, URL, pestañas y la respuesta debajo

La barra de estado dice 200 OK, seguido del tiempo y el tamaño. La pestaña Body tiene la respuesta:

{
"userId": 1,
"id": 1,
"title": "sunt aut facere repellat provident occaecati excepturi optio reprehenderit",
"body": "quia et suscipit\nsuscipit recusandae consequuntur expedita et cum\nreprehenderit molestiae ut ut quas totam\nnostrum rerum est autem sunt rem eveniet architecto"
}

La misma llamada en una terminal, para comparar:

Ventana de terminal
curl https://jsonplaceholder.typicode.com/posts/1

Un POST envía datos a la API. Este crea un post.

  1. Haz clic en Nuevo request y elige HTTP, como antes.

  2. Abre el menú del método (dice GET) y elige POST.

  3. Escribe la URL https://jsonplaceholder.typicode.com/posts.

  4. Abre la pestaña Body y elige JSON en el menú de arriba.

  5. Escribe el body en el editor:

    {
    "title": "Hello Luvin",
    "body": "My first post",
    "userId": 1
    }
  6. Pulsa Enviar (⌘/Ctrl + Enter).

El status es 201 Created, y el body devuelve tu post con un id que le dio la API:

{
"title": "Hello Luvin",
"body": "My first post",
"userId": 1,
"id": 101
}

Luvin agregó por ti el header Content-Type: application/json, porque el tipo de body es JSON. Abre Request enviado en la respuesta para ver todos los headers que salieron.

Método POST, URL https://jsonplaceholder.typicode.com/posts, Body → JSON con el texto de arriba.

El método le dice a la API qué quieres hacer. Elígelo en el menú a la izquierda de la URL.

Método Uso típico
GET Leer datos. No se envía body.
POST Crear algo, o enviar datos para procesar.
PUT Reemplazar algo que existe.
PATCH Cambiar una parte de algo que existe.
DELETE Eliminar algo.
HEAD Como GET, pero la API responde solo con los headers. No se envía body.
OPTIONS Preguntar qué permite la API.
Escribes Qué hace Luvin
{{baseUrl}}/posts/1 Reemplaza {{baseUrl}} con el valor del ambiente activo al enviar. Cambia de ambiente y el mismo request va a otro servidor.
https://api.example.com/posts?userId=1 Pasa lo que sigue a ? a la pestaña Params, y mantiene ambos sincronizados.
api.example.com/posts Agrega http:// al inicio cuando omites el esquema.
https://api.example.com//posts Reduce a una las barras repetidas de la ruta.
Un comando cURL pegado Completa todo el request. Mira cURL.

Escribe {{ en el campo para elegir una variable. Mira Variables y secretos.

Enviar queda deshabilitado mientras la URL está vacía. Mientras un request va en camino, el botón pasa a ser Cancelar.

  • Status. 2xx significa éxito, 4xx significa que el request tiene un problema, 5xx significa que el servidor falló. Luvin colorea cada familia.
  • Body. La respuesta. Pretty le da formato, Raw la muestra tal como llegó.
  • Headers y Cookies. Lo que la API envió además del body.
  • Request enviado. Lo que Luvin envió de verdad, para revisar tu lado.

Cada parte de la respuesta se explica en Lee una respuesta en detalle.