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

Carga del equipo

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

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.

empleadoIdsarray
opcional
Solo estas personas.
fecha_iniciostring
opcional
Por defecto el lunes de esta semana.
fecha_finstring
opcional
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

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

CasoResultado
Sin credenciales errorCode 401.
Más de 62 días errorCode 400.
Notas

Por MCP es carga_equipo.