Pruebas de API de Compras con Postman

¿Cómo podemos probar nuestras funcionalidades de compras?

Es importante asegurarnos de que nuestras funcionalidades relacionadas a compras estén funcionando correctamente en nuestro sistema. Aquí te guiamos en cómo probar esas funcionalidades usando Postman. Antes de comenzar con las pruebas, recuerda que es crucial reiniciar tu servicio para aplicar todos los cambios realizados. Esto garantiza que el servidor esté operativo y reciba peticiones adecuadamente. Examinaremos tres métodos esenciales expuestos a través de nuestra API: obtener todas las compras, recuperar compras por cliente, y guardar una nueva compra.

¿Cómo obtener todas las compras?

Comenzaremos probando la funcionalidad para obtener todas las compras registradas. Usando Postman, puedes cargar la solicitud correspondiente. La clave es enviar la petición de tipo GET a través de la API, lo que te permitirá recibir una respuesta con el historial de compras. Esto te proporciona una visión general de todas las transacciones asociadas a los clientes:

GET /api/purchases/all

1. Abre Postman.
2. Selecciona o crea una nueva solicitud GET.
3. Introduce la URL correspondiente a obtener todas las compras.
4. Haz clic en "Send".
5. Revisa la respuesta que contiene una lista de compras asociadas a los clientes.

¿Cómo verificar compras específicas por cliente?

La siguiente prueba involucra recuperar compras específicas asociadas a un cliente en particular. Deberíamos introducir la cédula del cliente en cuestión dentro de la solicitud para obtener solo las compras realizadas por esa persona:

GET /api/purchases/client/:clientId

1. En Postman, selecciona la opción para crear o editar una solicitud GET.
2. Introduce la URL que permite recuperar compras por cliente, sustituyendo :clientId por el ID del cliente real.
3. Haz clic en "Send".
4. Examina los resultados para verificar que solo se muestran las compras del cliente indicado.

¿Cómo guardar una nueva compra?

Finalmente, probaremos la capacidad de nuestro sistema para almacenar nuevas compras. Esta solicitud requiere el uso del método POST, introduciendo los detalles de la compra dentro del cuerpo del mensaje. Es importante incluir detalles tales como el tipo de pago y la fecha de la compra:

POST /api/purchases/new
{
  "paymentMethod": "tarjeta",
  "year": 2020,
  "clientId": "1234567"
}

1. En Postman, selecciona una nueva solicitud POST.
2. Introduce la URL para guardar una nueva compra.
3. Añade el body de la solicitud con los detalles necesarios.
4. Haz clic en "Send" y verifica que la compra se ha guardado correctamente.
5. Puedes confirmar su almacenamiento volviendo a utilizar la solicitud GET para obtener listas de compras, confirmando que la nueva transacción esté visible.

Este proceso garantiza que los servicios de compra estén operativos y sean fiables. Además, recuerda utilizar el archivo JSON proporcionado para importar las peticiones en tu entorno de Postman. Así, podrás estar seguro de que estás replicando el proceso y probando las solicitudes de manera eficiente. En clase futura, abordaremos la documentación de nuestra API con Swagger, ¡sigamos aprendiendo!