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

Agenda de una persona

GET https://api.afer.pro/api/v1/agenda
También disponible en: GET /api/v1/employees/{id}/agenda
Alias en castellano (v0, sigue operativo): 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.

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.

empleadoIdstring
opcional
La persona: id cifrado (de consultarEmpleados), correo o nombre. Vacío = quien llama. En la ruta va como {id}.
fecha_iniciostring
opcional
Desde (YYYY-MM-DD). Por defecto hoy.
fecha_finstring
opcional
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

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

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

Por MCP es agenda_persona.