En este tema, aprenderás a diseñar casos de prueba efectivos para asegurar que tus pruebas de API sean exhaustivas, eficientes y fáciles de mantener. Un caso de prueba bien diseñado puede ayudarte a identificar problemas en las APIs antes de que lleguen a producción, ahorrando tiempo y recursos.

1. Objetivo del Caso de Prueba:

   • Define claramente qué funcionalidad de la API estás probando.
   • Asegúrate de que el caso de prueba esté alineado con los requisitos del negocio.

2. Criterios de Aceptación:

   • Establece los criterios que deben cumplirse para que el caso de prueba se considere exitoso.
   • Incluye tanto los resultados esperados como las condiciones bajo las cuales se deben obtener.

3. Datos de Prueba:

   • Identifica los datos necesarios para ejecutar el caso de prueba.
   • Asegúrate de que los datos sean representativos de los escenarios del mundo real.

4. Pasos de Ejecución:

   • Detalla los pasos necesarios para ejecutar el caso de prueba.
   • Incluye cualquier configuración previa que deba realizarse.

5. Resultados Esperados:

   • Documenta claramente lo que se espera que devuelva la API.
   • Incluye tanto el cuerpo de la respuesta como los códigos de estado HTTP.

A continuación, se presenta un ejemplo de cómo estructurar un caso de prueba para una API de gestión de usuarios.

• Objetivo: Verificar que la API permite crear un nuevo usuario con datos válidos.
• Criterios de Aceptación:
  • La API debe devolver un código de estado 201 (Creado).
  • El cuerpo de la respuesta debe contener el ID del nuevo usuario.
• Datos de Prueba:

  {
    "nombre": "Juan Pérez",
    "email": "[email protected]",
    "contraseña": "segura123"
  }
  

• Pasos de Ejecución:
  1. Enviar una solicitud POST a /api/usuarios con los datos de prueba.
  2. Verificar que la respuesta tenga un código de estado 201.
  3. Confirmar que el cuerpo de la respuesta contiene un campo id.
• Resultados Esperados:
  • Código de estado: 201
  • Cuerpo de la respuesta:

    {
      "id": "12345",
      "nombre": "Juan Pérez",
      "email": "[email protected]"
    }
    

Ejercicio: Diseña un caso de prueba para verificar que la API de gestión de usuarios no permite crear un usuario con un correo electrónico ya registrado.

• Objetivo: Verificar que la API devuelve un error al intentar crear un usuario con un correo electrónico duplicado.
• Criterios de Aceptación:
  • La API debe devolver un código de estado 409 (Conflicto).
  • El cuerpo de la respuesta debe contener un mensaje de error adecuado.
• Datos de Prueba:

  {
    "nombre": "Ana López",
    "email": "[email protected]",
    "contraseña": "segura123"
  }
  

• Pasos de Ejecución:
  1. Enviar una solicitud POST a /api/usuarios con los datos de prueba.
  2. Verificar que la respuesta tenga un código de estado 409.
  3. Confirmar que el cuerpo de la respuesta contiene un mensaje de error que indique el conflicto de correo electrónico.
• Resultados Esperados:
  • Código de estado: 409
  • Cuerpo de la respuesta:

    {
      "error": "El correo electrónico ya está registrado."
    }
    

Solución:

1. Configura Postman para enviar una solicitud POST a la API con los datos de prueba proporcionados.
2. Ejecuta la solicitud y observa la respuesta.
3. Verifica que el código de estado y el mensaje de error coincidan con los resultados esperados.

Diseñar casos de prueba efectivos es crucial para garantizar la calidad de las APIs. Al seguir una estructura clara y detallada, puedes asegurarte de que tus pruebas sean exhaustivas y fáciles de entender. En el siguiente tema, exploraremos cómo manejar la autenticación en las pruebas de API, un aspecto esencial para probar APIs seguras.