🔌 Gestión de API

v1.0

🔑 Estado del Token Actual

🆕 Generar Nuevo Token

Versión de demostración: No se pueden generar nuevos tokens en esta versión.
El token actual será invalidado al generar uno nuevo.

📚 Documentación de Endpoints

La API REST de RegistroLab permite la integración externa con el sistema de registro de jornada laboral. Todos los endpoints requieren autenticación mediante el parámetro token en la URL.

🔑 GET /api/token

Gestión de tokens de autenticación

Parámetros:

  • action - Acción a realizar: verify o create
  • token - Token a verificar (requerido para verify)
  • username - Usuario administrador (requerido para create sin token)
  • password - Contraseña administrador (requerido para create sin token)
  • expiry_days - Días de expiración (opcional, default: 365)

Ejemplo de uso:

curl -X GET "http://registrolab.com/empresa/demo/api/token?action=verify&token=TU_TOKEN_AQUI"

📊 GET /api/registros

Obtener registros de jornada laboral con filtros opcionales

Parámetros:

  • fecha_inicio - Fecha de inicio (YYYY-MM-DD)
  • fecha_fin - Fecha de fin (YYYY-MM-DD)
  • id_trabajador - ID del trabajador
  • id_departamento - ID del departamento
  • limit - Límite de resultados (default: 100, max: 1000)
  • page - Página (default: 1)

Ejemplo de uso:

curl -X GET "http://registrolab.com/empresa/demo/api/registros?fecha_inicio=2024-01-01&fecha_fin=2024-01-31&token=TU_TOKEN_AQUI"

👥 GET /api/trabajadores

Obtener información de trabajadores

Parámetros:

  • activo - Filtrar por estado activo (1/0)
  • id_departamento - ID del departamento
  • id - ID específico del trabajador
  • limit - Límite de resultados
  • page - Página

Ejemplo de uso:

curl -X GET "http://registrolab.com/empresa/demo/api/trabajadores?activo=1&token=TU_TOKEN_AQUI"

🏢 GET /api/empresa

Obtener datos de la empresa

Ejemplo de uso:

curl -X GET "http://registrolab.com/empresa/demo/api/empresa?token=TU_TOKEN_AQUI"

🔍 GET /api/auditoria

Obtener logs de auditoría

Parámetros:

  • fecha - Fecha de los logs (YYYY-MM-DD, default: hoy)
  • usuario - Filtrar por usuario
  • modulo - Filtrar por módulo
  • nivel - Filtrar por nivel de log
  • limit - Límite de resultados
  • page - Página

Ejemplo de uso:

curl -X GET "http://registrolab.com/empresa/demo/api/auditoria?fecha=2024-01-15&token=TU_TOKEN_AQUI"

🔒 GET /api/integridad

Verificar integridad de la cadena de hashes

Parámetros:

  • id_trabajador - ID del trabajador específico
  • fecha_inicio - Fecha de inicio del análisis
  • fecha_fin - Fecha de fin del análisis

Ejemplo de uso:

curl -X GET "http://registrolab.com/empresa/demo/api/integridad?token=TU_TOKEN_AQUI"

🔐 Autenticación

Parámetro de Token

Todos los endpoints requieren el parámetro token en la URL:

?token=TU_TOKEN_AQUI

Formato de Respuesta

Todas las respuestas siguen el formato JSON estándar:

Respuesta exitosa:
{ "success": true, "data": { ... }, "timestamp": "2024-01-15T10:30:00Z", "version": "1.0" }
Respuesta de error:
{ "success": false, "error": { "code": "TOKEN_INVALID", "message": "El token proporcionado no es válido", "details": "Token expiró el 2024-01-10" }, "timestamp": "2024-01-15T10:30:00Z", "version": "1.0" }