Peticiones básicas con APIs de prueba

1. Configuración previa

Antes de enviar peticiones, es fundamental crear una colección que agrupe los endpoints relacionados. Para ello, haz clic en el botón "New" o en el icono "+" y selecciona "Collection". Asígnale un nombre descriptivo, por ejemplo, "Pruebas API de Blog". Dentro de la colección, cada petición que guardes debe tener un nombre claro (ej: "Obtener todos los posts") y una descripción detallada en la pestaña "Documentation" que explique su propósito, los parámetros que acepta y qué tipo de respuesta se espera. Esta documentación es invaluable para que otros desarrolladores entiendan cómo usar la API sin necesidad de preguntar.

imagen de postman imagen de postman

2. GET: lectura de datos

El método GET se utiliza para solicitar datos de un recurso específico. Es una operación de solo lectura, lo que significa que no modifica ningún dato en el servidor.

  1. En Postman, abre una nueva pestaña y selecciona GET en el menú desplegable de métodos HTTP.
  2. En el campo de la URL, introduce https://jsonplaceholder.typicode.com/posts. Esta URL apunta a un endpoint de la API de prueba JSONPlaceholder que devuelve una lista de posts.
  3. Haz clic en el botón Send. Postman enviará la petición al servidor.
  4. En la sección de respuesta, verás el cuerpo (Body) en formato JSON, que contiene una lista de objetos, donde cada objeto representa un post. También puedes revisar la pestaña Headers para ver las cabeceras de la respuesta y el código de estado (Status), que debería ser 200 OK, indicando que la solicitud fue exitosa.
  5. Para guardar la petición, haz clic en Save. Asígnale el nombre "Listado de posts" y guárdala en tu colección "Pruebas API de Blog".
[
  {
    "userId": 1,
    "id": 1,
    "title": "sunt aut facere repellat",
    "body": "quia et suscipit suscipit recusandae"
  }
]
imagen de postman

3. POST: creación de recursos

El método POST se utiliza para enviar datos a un servidor para crear un nuevo recurso. Por ejemplo, para crear un nuevo post en un blog.

  1. Haz clic en el botón + para crear una nueva petición en una nueva pestaña.
  2. Selecciona el método POST en el menú desplegable.
  3. La URL a utilizar es https://jsonplaceholder.typicode.com/posts.
  4. Ve a la pestaña Body, selecciona la opción raw y elige JSON en el menú desplegable. Esto indica que estás enviando datos en formato JSON.
  5. En el área de texto, introduce el objeto JSON que representa el nuevo post.
  6. Haz clic en Send. El servidor procesará la petición y, si tiene éxito, devolverá un código de estado 201 Created y el objeto recién creado, que ahora incluirá un id asignado por el servidor.

Cuerpo de la petición:

{
  "title": "Prueba desde Postman",
  "body": "Contenido de demostración",
  "userId": 7
}
imagen de postman

Respuesta del servidor:

{
  "title": "Prueba desde Postman",
  "body": "Contenido de demostración",
  "userId": 7,
  "id": 101
}
imagen de postman

4. PUT: actualización completa

El método PUT se utiliza para actualizar un recurso existente en su totalidad. Debes enviar el objeto completo, incluyendo los campos que no se modifican.

  1. Crea una nueva petición o duplica una existente. Selecciona el método PUT.
    2. imagen de postman
  2. La URL debe apuntar a un recurso específico, por ejemplo, https://jsonplaceholder.typicode.com/posts/1 para actualizar el post con id 1.
  3. En la pestaña Body, selecciona raw y JSON. Introduce el objeto JSON con los datos actualizados.
  4. Haz clic en Send. El servidor reemplazará el recurso existente con los datos que has enviado. La respuesta normalmente incluye el objeto actualizado y un código de estado 200 OK.
{
  "id": 1,
  "title": "Post actualizado",
  "body": "Cuerpo modificado desde una prueba",
  "userId": 1
}
imagen de postman

5. DELETE: eliminación de registros

El método DELETE se utiliza para eliminar un recurso específico.

  1. Crea una nueva petición y selecciona el método DELETE.
  2. La URL debe apuntar al recurso que deseas eliminar, por ejemplo, https://jsonplaceholder.typicode.com/posts/1.
  3. Normalmente, no es necesario enviar un cuerpo (Body) en una petición DELETE.
  4. Haz clic en Send. Si la eliminación es exitosa, el servidor responderá con un código de estado 200 OK o 204 No Content. Una respuesta 204 no incluirá un cuerpo.
  5. Es una buena práctica documentar en la descripción de la petición qué permisos o condiciones se necesitan para poder eliminar un recurso.
    6. imagen de postman

6. Buenas prácticas para repetir ejercicios

  1. Agrega etiquetas y carpetas por módulo para identificar rápidamente los endpoints.
  2. Utiliza variables para parametrizar identificadores y evitar editar manualmente la URL.
  3. Registra ejemplos de respuesta exitosos y de error para facilitar la depuración.
  4. Incluye comentarios en la sección de "Tests" explicando el objetivo de la petición.
Retornar