Agenda de una persona
https://api.afer.pro/api/v1/agenda
GET /api/v1/employees/{id}/agenda
GET https://api.afer.pro/api/v1/employees/{id}/agenda
Día a día: jornada planificada, días que no trabaja, lo que tiene con hora y sin hora, y las horas libres que le quedan.
Junta en una respuesta lo que hoy está repartido: los tramos de su turno (planificación), los festivos de la empresa y sus vacaciones y ausencias, y su agenda: partes, tareas, actividades de CRM y lo que viene de su Google Calendar.
libre es su jornada menos lo que tiene con hora. Lo que no tiene hora va en sin_hora y no se descuenta. Lo del Google de otra persona sale como «Ocupado», sin título.
GET /api/v1/agenda devuelve la de quien llama.
Envía tus claves API en las cabeceras X-API-KEY y X-API-SECRET. La cuenta sobre la que se opera se resuelve automáticamente a partir de la clave. Cómo obtener tus claves →
Este endpoint requiere autenticación (API key u OAuth).
Parámetros del cuerpo
El cuerpo de la petición es un objeto JSON con Content-Type: application/json.
empleadoIdstringopcional | La persona: id cifrado (de consultarEmpleados), correo o nombre. Vacío = quien llama. En la ruta va como {id}. |
fecha_iniciostringopcional | Desde (YYYY-MM-DD). Por defecto hoy. |
fecha_finstringopcional | Hasta (YYYY-MM-DD). Por defecto 7 días; como mucho 62. |
Ejemplo de petición
curl -X GET 'https://api.afer.pro/api/v1/agenda?fecha_inicio=2026-11-09&fecha_fin=2026-11-09' \
-H 'X-API-KEY: afer_tk_TU_TOKEN' \
-H 'X-API-SECRET: afer_sk_TU_SECRET'
<?php
$ch = curl_init('https://api.afer.pro/api/v1/agenda?fecha_inicio=2026-11-09&fecha_fin=2026-11-09');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'X-API-KEY: afer_tk_TU_TOKEN',
'X-API-SECRET: afer_sk_TU_SECRET',
]);
$respuesta = json_decode(curl_exec($ch), true);
curl_close($ch);
const respuesta = await fetch('https://api.afer.pro/api/v1/agenda?fecha_inicio=2026-11-09&fecha_fin=2026-11-09', {
method: 'GET',
headers: {
'X-API-KEY': 'afer_tk_TU_TOKEN',
'X-API-SECRET': 'afer_sk_TU_SECRET'
}
});
const resultado = await respuesta.json();
Respuesta
{
"errorCode": 200,
"errorMsg": "",
"data": {
"empleado": {
"empleadoId": "aBc…",
"nombre": "Pere Mas"
},
"periodo": {
"desde": "2026-11-09",
"hasta": "2026-11-09"
},
"resumen": {
"horas_jornada": 9,
"horas_ocupadas": 2,
"horas_libres": 7
},
"dias": [
{
"fecha": "2026-11-09",
"dia": "lunes",
"no_laborable": null,
"jornada": [
{
"desde": "08:00",
"hasta": "14:00"
},
{
"desde": "15:00",
"hasta": "18:00"
}
],
"sin_turno": false,
"ocupado": [
{
"desde": "09:00",
"hasta": "11:00",
"titulo": "Reunión de obra",
"origen": "crm",
"ref": null
}
],
"sin_hora": [],
"libre": [
{
"desde": "08:00",
"hasta": "09:00"
},
{
"desde": "11:00",
"hasta": "14:00"
},
{
"desde": "15:00",
"hasta": "18:00"
}
],
"horas_jornada": 9,
"horas_ocupadas": 2,
"horas_libres": 7
}
]
}
}
Errores
| Caso | Resultado |
|---|---|
| Sin credenciales | errorCode 401. |
| Más de 62 días o fechas mal escritas | errorCode 400. |
| La persona no es de la cuenta o el nombre da varias | errorCode 400. |
Por MCP es agenda_persona.