Este proyecto presenta una API que brinda a los usuarios la posibilidad de registrarse, iniciar sesión y cerrar sesión de manera eficiente. Diseñado para integrarse fácilmente con cualquier framework Frontend, utiliza el método de tokens de acceso generados por Laravel Sanctum. Estos tokens se generan y envían al usuario al autenticarse exitosamente, permitiendo así una implementación sencilla de autenticación en cualquier aplicación.
Para la correcta ejecución de este proyecto, necesitas tener las siguientes tecnologías instaladas en tu ordenador.
- PHP ^8.1
- Composer 2
- MySQL
- Clona este proyecto.
git clone https://github.com/JoanArturo/auth-laravel-sanctum.git- Instala las dependencias de PHP con composer.
composer install-
Crea una nueva base de datos con tu gestor de base de datos preferido. Como sugerencia podrías crear una base de datos llamada
auth_laravel. -
Crea una copia del archivo env.example, renombralo como .env y configura las variables de entorno correspondientes, preferiblemente las variables para la conexión a la base de datos.
APP_NAME=AuthAPI
APP_ENV=local
APP_KEY=
APP_DEBUG=true
APP_URL=http://localhost
LOG_CHANNEL=stack
LOG_DEPRECATIONS_CHANNEL=null
LOG_LEVEL=debug
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=tu_base_de_datos
DB_USERNAME=tu_username
DB_PASSWORD=tu_password
BROADCAST_DRIVER=log
CACHE_DRIVER=file
FILESYSTEM_DISK=local
QUEUE_CONNECTION=sync
SESSION_DRIVER=file
SESSION_LIFETIME=120
MEMCACHED_HOST=127.0.0.1
REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379
MAIL_MAILER=smtp
MAIL_HOST=mailpit
MAIL_PORT=1025
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS="hello@example.com"
MAIL_FROM_NAME="${APP_NAME}"
AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=
AWS_USE_PATH_STYLE_ENDPOINT=false
PUSHER_APP_ID=
PUSHER_APP_KEY=
PUSHER_APP_SECRET=
PUSHER_HOST=
PUSHER_PORT=443
PUSHER_SCHEME=https
PUSHER_APP_CLUSTER=mt1
VITE_APP_NAME="${APP_NAME}"
VITE_PUSHER_APP_KEY="${PUSHER_APP_KEY}"
VITE_PUSHER_HOST="${PUSHER_HOST}"
VITE_PUSHER_PORT="${PUSHER_PORT}"
VITE_PUSHER_SCHEME="${PUSHER_SCHEME}"
VITE_PUSHER_APP_CLUSTER="${PUSHER_APP_CLUSTER}"- Genera una APP_KEY.
php artisan key:generate- Ejecuta las migraciones.
php artisan migrate- Ejecuta el proyecto laravel.
php artisan serveA continuación se detallan los endpoints disponibles en la API:
| Método | Ruta | Descripción |
|---|---|---|
| POST | /api/v1/login | Inicia sesión de un usuario y devuelve un token de acceso junto con los datos del usuario. |
| DELETE | /api/v1/logout | Cierra la sesión del usuario autenticado, eliminando el token de acceso de la base de datos. |
| POST | /api/v1/register | Crea un nuevo usuario utilizando la información proporcionada en el body de la solicitud. |