API y Desarrolladores

Documentación técnica para integrar otros sistemas con iKelma

API REST para desarrolladores

Esta documentación está orientada a desarrolladores e integradores técnicos que necesiten conectar iKelma con otros sistemas de su organización. Encontrarás información detallada sobre endpoints, autenticación, ejemplos de código y casos de uso comunes.

Introducción y autenticación Endpoints de fichajes Usuarios y empleados Integraciones y casos de uso

Introducción y autenticación

Nuestra API REST utiliza autenticación Bearer con tokens asociados a tu cuenta. Todas las solicitudes deben realizarse sobre HTTPS.

Endpoint base

https://api.ikelma.com/v1

Ejemplo de cabeceras

Authorization: Bearer <TOKEN>
Content-Type: application/json
Accept: application/json

Endpoints de fichajes

Crear fichaje

POST /v1/timeclock/entries
{
  "employee_id": "EMP-001",
  "type": "check_in",
  "timestamp": "2025-01-01T08:00:00Z"
}

Listar fichajes

GET /v1/timeclock/entries?employee_id=EMP-001&from=2025-01-01&to=2025-01-31

Usuarios y empleados

Crear empleado

POST /v1/employees
{
  "first_name": "María",
  "last_name": "García",
  "email": "[email protected]"
}

Obtener empleado

GET /v1/employees/{id}

Integraciones y casos de uso

Ejemplos de integración con sistemas de RRHH, ERPs y herramientas de automatización.

Conectar con Google Sheets para exportar fichajes.
Webhooks para recibir eventos de fichaje en tiempo real.
Sincronización de empleados desde tu ERP.

Enlaces relacionados

Configuración de integraciones Informes y exportación de datos Requisitos del sistema