11. Endpoints de Registro, Login y Emisión de Bearer Tokens
Construye un AuthController completo: validación de credenciales con Hash::check, emisión de plainTextToken y respuesta JSON con datos del usuario.
El Ciclo de Autenticación de un Endpoint de Login
El endpoint POST /api/v1/login es el punto de partida donde el usuario presenta sus credenciales (email y password) y el dispositivo (por ejemplo "Xiaomi 13 de Carlos").
El flujo en Laravel debe ser estrictamente secuencial:
- Validar que el email tenga formato correcto y la contraseña esté presente.
- Buscar el usuario en la base de datos por su email.
- Comprobar la contraseña mediante
Hash::check($password, $user->password)(nunca comparar textos planos). - Si las credenciales no coinciden, abortar con
422 Unprocessableo401 Unauthorizedcon un mensaje genérico para no dar pistas a atacantes ("Credenciales incorrectas"). - Si coinciden, llamar a
$user->createToken($deviceName)->plainTextTokeny retornar el token en JSON.
⚡ Controlador AuthController Completo con Registro y Login en Sanctum
Implementación lista para producción con emisión de Bearer Tokens:
<?php
namespace App\Http\Controllers\Api\V1;
use App\Http\Controllers\Controller;
use App\Models\User;
use App\Http\Resources\UserResource;
use Illuminate\Http\Request;
use Illuminate\Http\JsonResponse;
use Illuminate\Support\Facades\Hash;
use Illuminate\Validation\ValidationException;
class AuthController extends Controller
{
/**
* POST /api/v1/registro
*/
public function registro(Request $request): JsonResponse
{
$datos = $request->validate([
'name' => ['required', 'string', 'max:100'],
'email' => ['required', 'string', 'email', 'unique:users,email'],
'password' => ['required', 'string', 'min:8'],
'device_name' => ['required', 'string', 'max:50'],
]);
$user = User::create([
'name' => $datos['name'],
'email' => $datos['email'],
'password' => Hash::make($datos['password']),
]);
$token = $user->createToken($datos['device_name'])->plainTextToken;
return response()->json([
'status' => 'success',
'mensaje' => 'Usuario registrado exitosamente',
'token' => $token,
'usuario' => new UserResource($user),
], 201);
}
/**
* POST /api/v1/login
*/
public function login(Request $request): JsonResponse
{
$credenciales = $request->validate([
'email' => ['required', 'email'],
'password' => ['required', 'string'],
'device_name' => ['required', 'string', 'max:50'],
]);
$user = User::where('email', $credenciales['email'])->first();
// Verificar existencia y comparar hash seguro
if (!$user || !Hash::check($credenciales['password'], $user->password)) {
throw ValidationException::withMessages([
'email' => ['Las credenciales proporcionadas son incorrectas.'],
]);
}
// Crear token asociado al nombre del dispositivo
$token = $user->createToken($credenciales['device_name'])->plainTextToken;
return response()->json([
'status' => 'success',
'token' => $token,
'usuario' => new UserResource($user),
], 200);
}
}
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Cuál es la propiedad de createToken() en Laravel Sanctum que contiene el token en texto plano que debe enviarse al cliente?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar APIs RESTful con Laravel, Resources & Sanctum y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.