Carga del equipo
https://api.afer.pro/api/v1/schedules/workload
GET https://api.afer.pro/api/v1/schedules/workload
Por persona y semana: horas de jornada frente a horas ya comprometidas, % de ocupación y estado.
Horas de jornada planificada (sin festivos ni ausencias) frente a lo que cada uno ya tiene con hora dentro de esa jornada. estado: con_sitio (< 50 %), normal, lleno (≥ 90 %), sobrecargado (tiene trabajo con hora fuera de su jornada) o sin_jornada. Lo que no tiene hora se cuenta en cosas_sin_hora.
Sin empleadoIds, todos los que tienen turno en el período, primero los más cargados.
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.
empleadoIdsarrayopcional | Solo estas personas. |
fecha_iniciostringopcional | Por defecto el lunes de esta semana. |
fecha_finstringopcional | Por defecto 2 semanas; como mucho 62 días. |
Ejemplo de petición
curl -X GET 'https://api.afer.pro/api/v1/schedules/workload?fecha_inicio=2026-11-09&fecha_fin=2026-11-15' \
-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/schedules/workload?fecha_inicio=2026-11-09&fecha_fin=2026-11-15');
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/schedules/workload?fecha_inicio=2026-11-09&fecha_fin=2026-11-15', {
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": {
"periodo": {
"desde": "2026-11-09",
"hasta": "2026-11-15"
},
"personas": [
{
"empleadoId": "aBc…",
"nombre": "Pere Mas",
"horas_jornada": 36,
"horas_ocupadas": 33.5,
"horas_libres": 2.5,
"horas_fuera_de_jornada": 0,
"ocupacion_pct": 93,
"estado": "lleno",
"cosas_sin_hora": 1,
"por_semana": [
{
"semana_del": "2026-11-09",
"horas_jornada": 36,
"horas_ocupadas": 33.5,
"horas_fuera_de_jornada": 0,
"ocupacion_pct": 93,
"estado": "lleno",
"cosas_sin_hora": 1
}
]
}
]
}
}
Errores
| Caso | Resultado |
|---|---|
| Sin credenciales | errorCode 401. |
| Más de 62 días | errorCode 400. |
Por MCP es carga_equipo.