En aquest tema, explorarem com realitzar proves d'APIs RESTful utilitzant Postman. Les APIs RESTful són àmpliament utilitzades per la seva simplicitat i escalabilitat. Aprendrem a provar les operacions CRUD (Crear, Llegir, Actualitzar, Eliminar) i a verificar que les respostes de l'API siguin correctes.
Conceptes Clau
-
REST (Representational State Transfer):
- Un estil arquitectònic per dissenyar serveis web.
- Utilitza mètodes HTTP estàndard com GET, POST, PUT, DELETE.
- Les dades es representen sovint en format JSON o XML.
-
Operacions CRUD:
- Crear (Create): Generalment utilitza el mètode POST.
- Llegir (Read): Utilitza el mètode GET.
- Actualitzar (Update): Utilitza els mètodes PUT o PATCH.
- Eliminar (Delete): Utilitza el mètode DELETE.
-
Codi d'Estat HTTP:
- 200 OK: Sol·licitud reeixida.
- 201 Created: Nou recurs creat.
- 204 No Content: Sol·licitud reeixida però sense contingut a retornar.
- 400 Bad Request: Sol·licitud incorrecta.
- 404 Not Found: Recurs no trobat.
- 500 Internal Server Error: Error del servidor.
Exemple Pràctic: Proves d'Operacions CRUD
- Crear un Nou Recurs
Sol·licitud POST:
Explicació:
- Utilitzem el mètode POST per crear un nou producte.
- El cos de la sol·licitud conté les dades del producte en format JSON.
- Llegir un Recurs
Sol·licitud GET:
Explicació:
- Utilitzem el mètode GET per obtenir informació sobre el producte amb ID 1.
- Esperem una resposta amb codi d'estat 200 OK i les dades del producte.
- Actualitzar un Recurs
Sol·licitud PUT:
PUT /api/products/1 Content-Type: application/json { "name": "Producte Actualitzat", "price": 39.99 }
Explicació:
- Utilitzem el mètode PUT per actualitzar el producte amb ID 1.
- El cos de la sol·licitud conté les dades actualitzades del producte.
- Eliminar un Recurs
Sol·licitud DELETE:
Explicació:
- Utilitzem el mètode DELETE per eliminar el producte amb ID 1.
- Esperem una resposta amb codi d'estat 204 No Content.
Exercici Pràctic
Objectiu: Realitzar proves d'operacions CRUD sobre una API RESTful fictícia de gestió de productes.
- Crear un nou producte i verificar que el codi d'estat sigui 201 Created.
- Llegir el producte creat i verificar que les dades retornades siguin correctes.
- Actualitzar el producte i verificar que el codi d'estat sigui 200 OK.
- Eliminar el producte i verificar que el codi d'estat sigui 204 No Content.
Solució
-
Crear un nou producte:
- Sol·licitud POST amb dades del producte.
- Verificar resposta amb codi 201 Created.
-
Llegir el producte:
- Sol·licitud GET per obtenir el producte.
- Verificar que les dades coincideixin amb les esperades.
-
Actualitzar el producte:
- Sol·licitud PUT amb dades actualitzades.
- Verificar resposta amb codi 200 OK.
-
Eliminar el producte:
- Sol·licitud DELETE per eliminar el producte.
- Verificar resposta amb codi 204 No Content.
Conclusió
En aquesta secció, hem après a realitzar proves d'operacions CRUD en APIs RESTful utilitzant Postman. Hem explorat com enviar sol·licituds HTTP i verificar les respostes per assegurar-nos que l'API funcioni correctament. Aquestes habilitats són fonamentals per a qualsevol desenvolupador o tester que treballi amb APIs. En el següent mòdul, explorarem funcions avançades de Postman per automatitzar i integrar proves en el flux de treball de desenvolupament.
Curs de Postman i Proves d'API
Mòdul 1: Introducció a les API i Postman
Mòdul 2: Proves Bàsiques d'API amb Postman
- Creació de la Teva Primera Sol·licitud
- Comprensió de la Sol·licitud i la Resposta
- Ús de les Col·leccions de Postman
- Variables d'Entorn a Postman
Mòdul 3: Tècniques Intermèdies de Proves d'API
- Enllaçar Sol·licituds
- Ús de Scripts de Postman
- Proves Basades en Dades amb Postman
- Proves d'APIs RESTful
Mòdul 4: Funcions Avançades de Postman
- Automatització de Proves amb Newman
- Integració Contínua amb Postman
- Servidors Simulats a Postman
- Tècniques Avançades de Scripting
Mòdul 5: Millors Pràctiques de Proves d'API
- Disseny de Casos de Prova Efectius
- Gestió de l'Autenticació
- Gestió d'Errors i Depuració
- Proves de Rendiment amb Postman