En aquest tema, explorarem com gestionar errors i depurar sol·licituds d'API utilitzant Postman. La gestió d'errors i la depuració són habilitats essencials per a qualsevol desenvolupador o provador d'APIs, ja que ajuden a identificar i solucionar problemes de manera eficient.
Conceptes Clau
-
Tipus d'Errors Comuns en APIs
- Errors del Client (4xx): Aquests errors indiquen que hi ha un problema amb la sol·licitud enviada pel client. Exemples inclouen:
- 400 Bad Request
- 401 Unauthorized
- 404 Not Found
- Errors del Servidor (5xx): Aquests errors indiquen que el servidor ha trobat una situació inesperada. Exemples inclouen:
- 500 Internal Server Error
- 503 Service Unavailable
- Errors del Client (4xx): Aquests errors indiquen que hi ha un problema amb la sol·licitud enviada pel client. Exemples inclouen:
-
Depuració de Sol·licituds d'API
- Revisió de la Sol·licitud: Assegura't que la sol·licitud està ben formada, amb els encapçalaments i el cos correctes.
- Anàlisi de la Resposta: Examina el codi d'estat i el cos de la resposta per obtenir pistes sobre el problema.
- Ús de la Consola de Postman: La consola de Postman proporciona informació detallada sobre les sol·licituds i respostes, incloent encapçalaments i errors.
-
Estratègies de Gestió d'Errors
- Validació de Respostes: Utilitza assertions per validar que les respostes compleixin amb les expectatives.
- Gestió d'Excepcions: Implementa lògica per gestionar errors de manera elegant, com ara reintents o notificacions.
Exemple Pràctic
Revisió de la Sol·licitud i Resposta
Suposem que estem provant una API que retorna informació d'un usuari. La sol·licitud pot semblar així:
Pas 1: Revisió de la Sol·licitud
- URL Correcte: Assegura't que l'URL és correcte i que el paràmetre d'identificació de l'usuari és vàlid.
- Encapçalaments: Verifica que l'encapçalament d'autorització conté un token vàlid.
Pas 2: Anàlisi de la Resposta
- Codi d'Estat: Si reps un 404, comprova que l'usuari existeix. Un 401 pot indicar un problema amb el token.
- Cos de la Resposta: Examina el cos per a missatges d'error que puguin proporcionar més informació.
Ús de la Consola de Postman
- Obrir la Consola: A Postman, fes clic a "View" > "Show Postman Console".
- Enviar la Sol·licitud: Observa la consola per veure els detalls de la sol·licitud i la resposta.
- Analitzar Errors: Busca missatges d'error o problemes de xarxa.
Exercici Pràctic
Objectiu: Practicar la gestió d'errors i la depuració amb una API de prova.
Instruccions
-
Configura una Sol·licitud a una API de Prova:
- Utilitza una API pública com
https://jsonplaceholder.typicode.com/posts/1
.
- Utilitza una API pública com
-
Indueix un Error:
- Modifica l'URL per provocar un error 404, com ara
https://jsonplaceholder.typicode.com/posts/9999
.
- Modifica l'URL per provocar un error 404, com ara
-
Depura l'Error:
- Utilitza la consola de Postman per identificar el problema.
- Ajusta la sol·licitud per corregir l'error.
Solució
-
Sol·licitud Original:
GET /posts/1 Host: jsonplaceholder.typicode.com
-
Sol·licitud amb Error:
GET /posts/9999 Host: jsonplaceholder.typicode.com
-
Depuració:
- Observa el codi d'estat 404 a la consola.
- Ajusta l'URL a
/posts/1
per obtenir una resposta vàlida.
Conclusió
La gestió d'errors i la depuració són components crítics en el procés de proves d'API. Mitjançant l'ús d'eines com la consola de Postman i l'anàlisi detallada de sol·licituds i respostes, pots identificar i solucionar problemes de manera eficient. Practicar aquestes tècniques millorarà la teva capacitat per gestionar errors i assegurar la qualitat de les teves proves d'API. En el següent tema, explorarem les proves de rendiment amb Postman per assegurar que les teves APIs funcionen de manera òptima sota càrrega.
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