Reto API - Pruebas Automatizadas con Karate Framework

Requisitos Previos

• Java JDK 11 o superior instalado
• Apache Maven 3.6 o superior instalado
• Conexión a internet (las pruebas consumen la API de https://api.demoblaze.com)

Verificar instalaciones:

java -version
mvn -version

Estructura del Proyecto (Patrón POM)

reto-api/
├── pom.xml                              -> Dependencias Maven (Karate 0.9.6 + JUnit5)
├── README.md                            -> Este archivo
├── conclusiones.md                      -> Hallazgos del ejercicio
└── src/
    └── test/
        ├── java/
        │   └── runner/
        │       └── TestRunner.java      -> Runner JUnit5 que lanza las pruebas
        └── resources/
            ├── karate-config.js         -> Configuración global (baseUrl)
            ├── pages/                   -> PAGE OBJECTS: abstraen las llamadas HTTP
            │   ├── SignupPage.feature   -> Encapsula POST /signup
            │   └── LoginPage.feature    -> Encapsula POST /login
            └── tests/                  -> TESTS: llaman a los page objects y validan
                ├── SignupTest.feature   -> TC01 y TC02
                └── LoginTest.feature   -> TC03 y TC04

Casos de Prueba

ID	Descripción	Feature
TC01	Crear un nuevo usuario exitosamente	SignupTest.feature
TC02	Intentar crear un usuario ya existente	SignupTest.feature
TC03	Login con usuario y contraseña correctos	LoginTest.feature
TC04	Login con usuario y contraseña incorrectos	LoginTest.feature

Pasos de Ejecución

1. Abrir una terminal en la carpeta raíz del proyecto:

cd ruta\al\proyecto\Reto_API

2. Descargar dependencias (solo la primera vez):

mvn dependency:resolve

3. Ejecutar TODAS las pruebas:

mvn test

4. Ejecutar solo las pruebas de Signup:

mvn test -Dkarate.options="classpath:tests/SignupTest.feature"

5. Ejecutar solo las pruebas de Login:

mvn test -Dkarate.options="classpath:tests/LoginTest.feature"

Reportes

Después de ejecutar mvn test, los reportes se generan automáticamente en:

target/surefire-reports/karate-summary.html

Abrir en el navegador para ver el reporte visual completo.

Notas

• Los usernames se generan con timestamp (currentTimeMillis) para garantizar unicidad en TC01, TC03 y TC04.
• TC02 registra el mismo usuario dos veces en el mismo escenario para forzar el error de duplicado.
• TC04 crea un usuario con clave correcta y luego intenta login con clave incorrecta.