Postman es una herramienta popular y ampliamente utilizada para probar APIs. Permite a los desarrolladores enviar solicitudes HTTP, inspeccionar respuestas y automatizar pruebas. En esta sección, aprenderás cómo utilizar Postman para probar tus APIs RESTful de manera efectiva.

Postman es una plataforma de colaboración para el desarrollo de APIs que proporciona un entorno amigable para construir, probar, documentar y compartir APIs. Es especialmente útil para:

• Enviar solicitudes HTTP (GET, POST, PUT, DELETE, etc.).
• Verificar respuestas de las APIs.
• Automatizar pruebas.
• Documentar APIs.

Puedes descargar Postman desde su sitio oficial. Está disponible para Windows, macOS y Linux.

• Workspace: Área de trabajo donde puedes organizar tus colecciones y entornos.
• Collections: Conjunto de solicitudes agrupadas que puedes organizar por proyecto o funcionalidad.
• Request Builder: Interfaz donde puedes construir y enviar solicitudes HTTP.
• Response Viewer: Área donde puedes ver las respuestas de las solicitudes enviadas.

1. Abrir Postman.
2. Crear una nueva solicitud:
   • Haz clic en "New" y selecciona "Request".
3. Configurar la solicitud:
   • Selecciona el método HTTP (GET, POST, etc.).
   • Introduce la URL de la API.
   • Añade cualquier parámetro necesario.
4. Enviar la solicitud:
   • Haz clic en "Send".

Ejemplo práctico

Supongamos que tienes una API en https://jsonplaceholder.typicode.com/posts.

1. Selecciona el método GET.
2. Introduce la URL: https://jsonplaceholder.typicode.com/posts.
3. Haz clic en "Send".

La respuesta de la API se mostrará en el Response Viewer. Puedes ver:

• Status Code: Código de estado HTTP (e.g., 200 OK).
• Headers: Encabezados de la respuesta.
• Body: Cuerpo de la respuesta, que puede estar en formato JSON, XML, etc.

1. Crear una nueva solicitud.
2. Configurar la solicitud:
   • Selecciona el método HTTP POST.
   • Introduce la URL de la API.
   • En la pestaña "Body", selecciona "raw" y elige el formato (e.g., JSON).
   • Introduce el cuerpo de la solicitud.
3. Enviar la solicitud.

Ejemplo práctico

Supongamos que quieres crear un nuevo post en https://jsonplaceholder.typicode.com/posts.

1. Selecciona el método POST.
2. Introduce la URL: https://jsonplaceholder.typicode.com/posts.
3. En la pestaña "Body", selecciona "raw" y elige "JSON".
4. Introduce el siguiente JSON en el cuerpo de la solicitud:

5. Haz clic en "Send".

La respuesta de la API se mostrará en el Response Viewer. Puedes ver el nuevo recurso creado.

1. Crear una nueva colección:
   • Haz clic en "New" y selecciona "Collection".
   • Asigna un nombre a la colección.
2. Añadir solicitudes a la colección:
   • Arrastra y suelta las solicitudes en la colección.

Postman permite escribir scripts de prueba en JavaScript para automatizar la validación de respuestas.

Ejemplo de script de prueba

Newman es una herramienta de línea de comandos para ejecutar colecciones de Postman.

Instalación de Newman

Ejecutar una colección

1. Crear una colección en Postman.
2. Añadir una solicitud GET:
   • URL: https://jsonplaceholder.typicode.com/posts/1
   • Verificar que el status code es 200.
3. Añadir una solicitud POST:
   • URL: https://jsonplaceholder.typicode.com/posts
   • Body:

   {
     "title": "foo",
     "body": "bar",
     "userId": 1
   }
   

   • Verificar que el status code es 201.

1. Crear la colección:
   • Nombre: API de Ejemplo.
2. Añadir solicitud GET:
   • URL: https://jsonplaceholder.typicode.com/posts/1.
   • Script de prueba:

   pm.test("Status code is 200", function () {
       pm.response.to.have.status(200);
   });
   

3. Añadir solicitud POST:
   • URL: https://jsonplaceholder.typicode.com/posts.
   • Body:

   {
     "title": "foo",
     "body": "bar",
     "userId": 1
   }
   

   • Script de prueba:

   pm.test("Status code is 201", function () {
       pm.response.to.have.status(201);
   });
   

Postman es una herramienta poderosa y versátil para probar APIs. Permite a los desarrolladores enviar solicitudes HTTP, verificar respuestas y automatizar pruebas de manera eficiente. En esta sección, aprendiste cómo enviar solicitudes GET y POST, escribir scripts de prueba y automatizar pruebas con Newman. Con esta base, estarás bien preparado para utilizar Postman en tus proyectos de desarrollo de APIs RESTful.