En aquest tema, aprendrem com dissenyar casos de prova efectius per a les proves d'API. Els casos de prova ben dissenyats són fonamentals per assegurar que les nostres proves siguin exhaustives i eficients. A continuació, desglossarem els conceptes clau i proporcionarem exemples pràctics per ajudar-te a crear casos de prova robustos.

1. Objectiu del Cas de Prova

   • Defineix clarament què vols aconseguir amb el cas de prova.
   • Assegura't que l'objectiu sigui mesurable i específic.

2. Identificació de Requisits

   • Revisa els requisits de l'API per identificar què cal provar.
   • Considera tant els requisits funcionals com els no funcionals.

3. Criteris d'Èxit i Fracàs

   • Estableix criteris clars per determinar si el cas de prova ha passat o fallat.
   • Els criteris han de ser objectius i fàcils de verificar.

4. Dades de Prova

   • Selecciona dades de prova representatives i variades.
   • Considera l'ús de dades límit i casos extrems.

5. Passos del Cas de Prova

   • Descriu els passos necessaris per executar el cas de prova.
   • Assegura't que els passos siguin clars i seqüencials.

6. Documentació i Reportatge

   • Documenta els resultats de cada cas de prova.
   • Utilitza eines de reportatge per fer un seguiment dels resultats.

Suposem que estem provant una API de gestió d'usuaris. Un dels requisits és que l'API ha de permetre crear un nou usuari amb un nom d'usuari únic.

• Objectiu: Verificar que l'API permet crear un nou usuari amb un nom d'usuari únic.
• Requisits: L'API ha de retornar un codi d'estat 201 (Creat) i el cos de la resposta ha de contenir l'ID de l'usuari nou.
• Criteris d'Èxit: La resposta ha de tenir un codi d'estat 201 i un ID d'usuari vàlid.
• Dades de Prova:
  • Nom d'usuari: "nou_usuari_123"
  • Correu electrònic: "[email protected]"
• Passos:
  1. Envia una sol·licitud POST a l'endpoint /users amb les dades de prova.
  2. Verifica que el codi d'estat de la resposta sigui 201.
  3. Comprova que el cos de la resposta conté un camp id amb un valor vàlid.
• Documentació: Registra els resultats de la prova i qualsevol error trobat.

Crea un cas de prova per verificar que l'API no permet crear un usuari amb un nom d'usuari duplicat.

• Objectiu: Verificar que l'API no permet crear un usuari amb un nom d'usuari duplicat.
• Requisits: L'API ha de retornar un codi d'estat 409 (Conflict) si el nom d'usuari ja existeix.
• Criteris d'Èxit: La resposta ha de tenir un codi d'estat 409.
• Dades de Prova:
  • Nom d'usuari: "existent_usuari"
  • Correu electrònic: "[email protected]"
• Passos:
  1. Envia una sol·licitud POST a l'endpoint /users amb les dades de prova.
  2. Verifica que el codi d'estat de la resposta sigui 409.
• Documentació: Registra els resultats de la prova i qualsevol error trobat.

Dissenyar casos de prova efectius és essencial per garantir la qualitat de les proves d'API. Assegura't de definir objectius clars, utilitzar dades de prova adequades i documentar els resultats de manera precisa. Amb aquests passos, estaràs ben preparat per crear casos de prova que cobreixin tots els aspectes crítics de les teves API. En el següent tema, explorarem com gestionar l'autenticació en les proves d'API.