API Documentation

Ejemplos de uso con curl. Documentación completa en /api/docs

GET/api/health

Verifica el estado del sistema y capacidades disponibles.

curl https://bestlife-os.vercel.app/api/health

GET/api/docs

Documentación completa de la API en formato OpenAPI 3.1.

curl https://bestlife-os.vercel.app/api/docs

GET/api/dashboard/stats

Estadísticas en tiempo real del tenant (requiere autenticación).

curl https://bestlife-os.vercel.app/api/dashboard/stats \
  -H "Cookie: next-auth.session-token=TU_TOKEN"

POST/api/public/register

Registra un nuevo tenant con plugin de nómina.

curl -X POST https://bestlife-os.vercel.app/api/public/register \
  -H "Content-Type: application/json" \
  -d '{"nombre":"Mi Empresa","slug":"mi-empresa","email":"admin@miempresa.com","password":"segura123","pluginId":"nomina-mx"}'

GET/api/nomina-mx/empleados

Lista los empleados activos del tenant.

curl https://bestlife-os.vercel.app/api/nomina-mx/empleados \
  -H "Cookie: next-auth.session-token=TU_TOKEN"

POST/api/ocr/ine

Extrae datos de una INE mexicana usando IA.

curl -X POST https://bestlife-os.vercel.app/api/ocr/ine \
  -H "Content-Type: application/json" \
  -d '{"imageUrl":"https://ejemplo.com/ine.jpg"}'

POST/api/agent-ia/chat

Envía un mensaje al agente IA con herramientas.

curl -X POST https://bestlife-os.vercel.app/api/agent-ia/chat \
  -H "Content-Type: application/json" \
  -H "Cookie: next-auth.session-token=TU_TOKEN" \
  -d '{"message":"Calcula ISR para sueldo de 30000"}'

GET/api/nomina-mx/recibos/pdf?reciboId=ID

Descarga un recibo de nómina en formato PDF.

curl https://bestlife-os.vercel.app/api/nomina-mx/recibos/pdf?reciboId=TU_RECIBO_ID \
  -H "Cookie: next-auth.session-token=TU_TOKEN" \
  -o recibo.pdf