Días cortos de gente
https://api.afer.pro/api/v1/schedules/coverage-gaps
GET https://api.afer.pro/api/v1/schedules/coverage-gaps
Los ratos en que un departamento tiene planificadas menos personas de las que pide su franja de horas punta.
Los mismos huecos que el panel lateral del cuadrante de turnos: qué día y hora, cuántas personas faltan, cuántas hacen falta y cuántas hay, y de qué perfil, de más a menos grave. Solo hay huecos en departamentos con franjas de horas punta definidas.
Para cubrir uno: carga del equipo o agenda para ver quién tiene sitio, y cambiar el turno.
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.
fecha_iniciostringopcional | Por defecto hoy. |
fecha_finstringopcional | Por defecto 14 días; como mucho 62. |
departamentoIdsarrayopcional | Solo estos departamentos (consultarDepartamentos). |
limiteintegeropcional | Por defecto 40, máximo 100. |
Ejemplo de petición
curl -X GET 'https://api.afer.pro/api/v1/schedules/coverage-gaps?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/coverage-gaps?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/coverage-gaps?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"
},
"num_huecos": 1,
"huecos": [
{
"fecha": "2026-11-14",
"dia": "sábado",
"departamentoId": "yZa…",
"departamento": "Sala",
"desde": "13:00",
"hasta": "16:00",
"faltan": 2,
"hacen_falta": 5,
"planificadas": 3,
"perfil": "1 camarero"
}
]
}
}
Errores
| Caso | Resultado |
|---|---|
| Sin credenciales | errorCode 401. |
| Departamento que no es de tu cuenta | errorCode 400. |
| El cálculo del cuadrante no está disponible en el servidor | errorCode 503. |
Por MCP es dias_cortos_de_gente.