Base URL https://api.afer.pro Referencia aferapp.com Reservar demo

Días cortos de gente

GET https://api.afer.pro/api/v1/schedules/coverage-gaps
Alias en castellano (v0, sigue operativo): 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.

Autenticación

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_iniciostring
opcional
Por defecto hoy.
fecha_finstring
opcional
Por defecto 14 días; como mucho 62.
departamentoIdsarray
opcional
Solo estos departamentos (consultarDepartamentos).
limiteinteger
opcional
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

200 · application/json
{
    "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

CasoResultado
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.
Notas

Por MCP es dias_cortos_de_gente.