Gestión de Usuarios y Tokens

Servicios generales para la administración de cuentas de usuario, consulta de perfil y ciclo de vida de tokens de acceso para la plataforma Paladins APIs.

---

👤 Información del Usuario Actual

Obtiene el perfil y detalles del usuario asociado al Bearer token enviado en la cabecera.

GET/api/v1/users

Encabezados Requeridos

Authorization: Bearer {TU_TOKEN}
Accept: application/json

Respuestas Posibles

200 OK — Consulta Exitosa

{
  "id": 1,
  "name": "Miguel Angel Muñoz Pozos",
  "email": "mmunozpozos@gmail.com",
  "email_verified_at": "2023-08-02T21:49:21.000000Z",
  "two_factor_confirmed_at": null,
  "current_team_id": null,
  "profile_photo_path": null,
  "created_at": "2023-08-02T21:49:21.000000Z",
  "updated_at": "2023-08-02T21:49:21.000000Z",
  "profile_photo_url": "https://ui-avatars.com/api/?name=M+A+M+P&color=7F9CF5&background=EBF4FF"
}

401 Unauthorized — Token No Válido

{
  "message": "Unauthenticated."
}

Ejemplo con cURL

curl --location 'https://bridge.paladins.mx/api/v1/users' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {TU_TOKEN}'

---

➕ Crear un Nuevo Usuario

Permite registrar una nueva cuenta de usuario en la plataforma.

POST/api/v1/users

Encabezados

Content-Type: application/json
Accept: application/json

Cuerpo de la Petición (JSON)

{
  "name": "Nombre de Usuario",
  "email": "usuario@example.com",
  "password": "contraseña123",
  "password_confirmation": "contraseña123"
}

Respuestas Posibles

201 Created — Usuario Creado

{
  "message": "Usuario creado exitosamente",
  "user": {
    "name": "Nombre de Usuario",
    "email": "usuario1@example.com",
    "updated_at": "2025-05-01T01:10:59.000000Z",
    "created_at": "2025-05-01T01:10:59.000000Z",
    "id": 4,
    "profile_photo_url": ""
  }
}

422 Unprocessable Content — Error de Validación

{
  "errors": {
    "email": [
      "The email has already been taken."
    ]
  }
}

Ejemplo con cURL

curl --location 'https://bridge.paladins.mx/api/v1/users' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "name": "Nombre de Usuario",
    "email": "usuario1@example.com",
    "password": "contraseña123",
    "password_confirmation": "contraseña123"
  }'

---

🔑 Generar Token de Acceso

Permite autenticar con correo y contraseña para emitir un nuevo Bearer Token.

POST/api/v1/users/tokens

Encabezados

Content-Type: application/json
Accept: application/json

Cuerpo de la Petición (JSON)

{
  "email": "admin@paladins.mx",
  "password": "tu_password_aqui"
}

Respuestas Posibles

201 Created — Token Generado

{
  "message": "Token generado exitosamente",
  "token": "2|bNYyqNKKSb6TsASkQ5jdr0vwVIUMuXaL4HLHBaTk133b1b02"
}

401 Unauthorized — Credenciales Incorrectas

{
  "message": "Credenciales incorrectas"
}

Ejemplo con cURL

curl --location 'https://bridge.paladins.mx/api/v1/users/tokens' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "email": "admin@paladins.mx",
    "password": "tu_password_aqui"
  }'

---

🗑️ Revocar Todos los Tokens del Usuario

Invalida y elimina todas las sesiones y tokens asociados a la cuenta.

DELETE/api/v1/users/tokens

Encabezados

Content-Type: application/json
Accept: application/json
Authorization: Bearer {TU_TOKEN}

Cuerpo de la Petición (JSON)

{
  "email": "usuario@example.com",
  "password": "tu_password_aqui"
}

Respuestas Posibles

200 OK — Tokens Revocados

{
  "message": "All tokens deleted successfully."
}

401 Unauthorized

{
  "message": "Unauthenticated."
}