1. Objetivo general
Construir una colección integral que consolide buenas prácticas de organización, variables, autenticación, tests y automatización en un flujo coherente.
2. Preparación del entorno
- Crea la colección "Proyecto Integrador" con carpetas para cada servicio.
- Define variables de colección para credenciales genéricas y
{{baseUrl}}
según el recurso.
- Configura ambientes Pruebas y Producción con API keys y URLs correspondientes.
3. Carpeta JSONPlaceholder
Utiliza el servicio gratuito JSONPlaceholder para simular operaciones CRUD.
- Petición
GET
a {{baseUrl}}/posts
.
- Petición
POST
con un cuerpo de ejemplo para crear un recurso.
- Petición
PUT
que actualice el post recién creado.
- Petición
DELETE
que elimine el recurso y valide el código de estado.
- Incluye tests que comprueben que los campos
title
y body
existen en las respuestas.
4. Carpeta reqres.in
Practica la creación de usuarios con la API de demostración reqres.in.
- Define una petición
POST
a https://reqres.in/api/users
con campos name
y job
.
- Agrega tests que almacenen
id
y createdAt
como variables de colección.
- Prepara una petición
GET
que recupere el usuario recién creado utilizando la variable.
5. Carpeta GitHub
Consulta el buscador de repositorios de la API de GitHub con autenticación.
- Guarda un token personal en una variable de entorno y aplica autorización tipo Bearer Token.
- Petición
GET
a https://api.github.com/search/repositories?q=postman
.
- Tests: verificar que
total_count
sea mayor a cero y que el primer elemento contenga full_name
.
- Extrae el nombre del repositorio destacado para registrarlo en el reporte final.
6. Carpeta OpenWeather
Consulta la información climática mediante la API de OpenWeather.
- Define variables
baseUrl
, apiKey
y city
por ambiente.
- Petición
GET
a {{baseUrl}}
/data/2.5/weather?q={{city}}&appid={{apiKey}}.
- Tests: confirmar que la respuesta incluya
weather
, main.temp
y un código de estado exitoso.
7. Integración de variables y scripts
- Usa scripts de pre-request para generar un
correlationId
reutilizable en headers.
- Guarda resultados relevantes (por ejemplo, temperatura y nombre del repositorio) en variables de entorno para mostrarlos en reportes.
- Documenta en la colección cómo deben configurarse las variables antes de ejecutar.
8. Automatización y documentación
- Ejecuta la colección completa con el Collection Runner y exporta los resultados.
- Genera documentación automática y publica la URL para el equipo.
- Exporta la colección y los ambientes para ejecutarlos en Newman dentro de una pipeline.