API Prueba Técnica — Uso

A continuación se describen los pasos básicos para configurar y usar la API REST provista en este repositorio.

Resumen:

• Autenticación: POST /api/login (devuelve token)
• Cierre sesión: POST /api/logout (token requerido)
• Recurso protegido: registros (implemented: GET index, POST store)

Requisitos

• PHP 8.2+
• Composer

Configuración rápida

composer install
cp .env.example .env
php artisan key:generate
# Configura DB en .env y luego:
php artisan migrate
php artisan serve

Endpoints principales

POST /api/login

• Body JSON: { "email": "test@example.com", "password": "password" }
• Headers: Accept: application/json, Content-Type: application/json
• Ejemplo curl:

curl -X POST http://localhost:8000/api/login \
  -H "Accept: application/json" -H "Content-Type: application/json" \
  -d '{"email": "test@example.com", "password": "password"}'

• Respuesta: { "token": "<token>", "user": { ... } }

POST /api/logout

• Header: Authorization: Bearer <token>
• Respuesta: { "message": "Cierre de sesión exitoso" }

GET /api/registros

• Proporciona los registros del usuario autenticado.
• Headers: Accept: application/json, Authorization: Bearer <token>

POST /api/registros

• Body JSON: { "nombre": "Nombre", "descripcion": "Opcional" }
• Validaciones: nombre required|string|max:255, descripcion nullable|string
• Respuesta: 201 Created con el JSON del registro creado.

Nota: Route::apiResource('registros', RegistroController::class) genera rutas show, update y destroy, pero en app/Http/Controllers/Api/RegistroController.php solamente están implementados index y store.

Errores comunes

• HTML en vez de JSON: Asegúrate de enviar Accept: application/json.
• 401: Token falta o inválido. Envía Authorization: Bearer <token>.
• 422: Validación; revisa nombres de campos y contenido.
• 500: Revisa storage/logs/laravel.log.

License

The Laravel framework is open-sourced software licensed under the MIT license.