Visión general

Referencia de API

El backend de AS Starter expone una API REST versionada consumida por el frontend Angular. Todos los endpoints devuelven JSON. La autenticación usa Laravel Sanctum.

Base URL

Local

http://api.mr-seller.test

Test

https://testapi.mr-seller.de

Producción

https://api.mr-seller.de

Formato de request

Content-Type application/json

Accept application/json

X-XSRF-TOKEN Requerido para requests que cambian estado (POST, PUT, DELETE). Se obtiene desde /sanctum/csrf-cookie.

Visión general

Autenticación

La API usa autenticación por cookie con Sanctum. Antes de cualquier request que cambie estado, hay que obtener el cookie CSRF. Tras el login el cookie de sesión se establece automáticamente.

Handshake CSRF

GET /sanctum/csrf-cookie

Llámalo antes de register o login. Establece el cookie XSRF-TOKEN.

Visión general

Errores

Código	Significado
`400`	Bad request
`401`	No autenticado
`403`	Prohibido
`404`	No encontrado
`422`	Error de validación
`500`	Error de servidor

Respuesta de error de validación

{
  "message": "The given data was invalid.",
  "errors": {
    "email": ["The email field is required."]
  }
}

Auth

Registro

POST /api/auth/register

Registra una cuenta de usuario nueva.

Cuerpo del request

{
  "name": "string",
  "username": "string",
  "email": "string",
  "password": "string",
  "password_confirmation": "string"
}

Respuesta 201

{
  "message": "Registration successful.",
  "user": { ... }
}

Auth

Login

POST /api/auth/login

Autentica a un usuario existente.

Cuerpo del request

{
  "email": "string",
  "password": "string"
}

Respuesta 200

{
  "user": { ... },
  "token": "string"
}

Site

Configuración del sitio

GET /api/site/config

Devuelve la configuración global del sitio — nombre, locales, features, módulos activos.

Más endpoints en documentación — perfil, medios, mensajería, interacciones, ads y rutas de admin.