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

  1. 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
  2. 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.
  3. 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í:

GET /api/users/123
Host: example.com
Authorization: Bearer <token>

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

  1. Obrir la Consola: A Postman, fes clic a "View" > "Show Postman Console".
  2. Enviar la Sol·licitud: Observa la consola per veure els detalls de la sol·licitud i la resposta.
  3. 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

  1. Configura una Sol·licitud a una API de Prova:

    • Utilitza una API pública com https://jsonplaceholder.typicode.com/posts/1.
  2. Indueix un Error:

    • Modifica l'URL per provocar un error 404, com ara https://jsonplaceholder.typicode.com/posts/9999.
  3. Depura l'Error:

    • Utilitza la consola de Postman per identificar el problema.
    • Ajusta la sol·licitud per corregir l'error.

Solució

  1. Sol·licitud Original:

    GET /posts/1
    Host: jsonplaceholder.typicode.com
    
  2. Sol·licitud amb Error:

    GET /posts/9999
    Host: jsonplaceholder.typicode.com
    
  3. 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.

© Copyright 2024. Tots els drets reservats