API REST

Disponible en el plan Empresa. Permite integrar AlteaTick con tus sistemas externos.

Autenticación

Todas las peticiones requieren una API Key en la cabecera:

x-api-key: at_xxxxxxxxxxxxxxxxxxxx

Genera y gestiona tus API Keys desde Dashboard → Configuración → API Keys. Las keys solo son visibles en el momento de su creación.

URL base

https://alteatick.com/api/v1

Endpoints

Empleados

GET

/api/v1/empleados

Lista todos los empleados activos de la empresa.

Respuesta

[
  {
    "id": "cmq0yhj3d...",
    "name": "Ana García",
    "email": "ana@empresa.com",
    "active": true,
    "createdAt": "2026-01-15T10:00:00.000Z"
  }
]

Fichajes

GET

/api/v1/fichajes

Lista los fichajes de la empresa. Máximo 1000 resultados.

POST

/api/v1/fichajes

Registra un nuevo fichaje para un empleado.

Parámetros GET

from	ISO 8601	opcional	Fecha de inicio. Ej: 2026-06-01T00:00:00Z
to	ISO 8601	opcional	Fecha de fin. Ej: 2026-06-30T23:59:59Z
employeeId	string	opcional	Filtra por ID de empleado.

Body POST

employeeId	string	requerido	ID del empleado.
type	enum	requerido	ENTRADA · INICIO_PAUSA · FIN_PAUSA · SALIDA
timestamp	ISO 8601	opcional	Fecha y hora del fichaje. Si se omite, se usa la hora actual.
workdayType	enum	opcional	PRESENCIAL · TELETRABAJO. Por defecto: PRESENCIAL.
notes	string	opcional	Notas opcionales.

Ejemplo POST

curl -X POST https://alteatick.com/api/v1/fichajes \
  -H "x-api-key: at_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "employeeId": "cmq0yhj3d...",
    "type": "ENTRADA",
    "workdayType": "PRESENCIAL"
  }'

Ausencias

GET

/api/v1/ausencias

Lista las ausencias de la empresa. Máximo 500 resultados.

Parámetros GET

status	enum	opcional	PENDIENTE · APROBADA · RECHAZADA
employeeId	string	opcional	Filtra por ID de empleado.

Códigos de error

Código	Descripción
200	OK — Petición correcta.
201	Created — Recurso creado correctamente.
400	Bad Request — Faltan campos obligatorios o formato incorrecto.
401	Unauthorized — API Key inválida, ausente o sin plan ENTERPRISE.
404	Not Found — El recurso solicitado no existe.
429	Too Many Requests — Rate limit superado.

Límites

— Máximo 1.000 fichajes por consulta (usa from y to para paginar).

— Máximo 500 ausencias por consulta.

— Para consultas o soporte técnico sobre la API: soporte@alteatick.com