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

Plan de un proyecto

GET https://api.afer.pro/api/v1/projects/{id}/plan
Alias en castellano (v0, sigue operativo): GET https://api.afer.pro/api/v1/projects/{id}/plan

Las tareas de un proyecto en orden de fechas, con dependencias, personas y avisos de lo que no cuadra.

Como el gantt: inicio, fin, progreso, a qué tarea espera cada una y quién la hace. Avisos por tarea: sin_fecha, sin_asignar, vencida, antes_que_su_bloqueo (empieza antes de que acabe la tarea a la que espera) y gente_no_disponible (alguien que la hace no trabaja algún día de la tarea).

Para moverlas: agendar una, o replanificar una y las que esperan a ella.

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.

proyectoIdstring
obligatorio
El proyecto (buscarObra). En la ruta, {id}.

Ejemplo de petición

curl -X GET 'https://api.afer.pro/api/v1/projects/aBc123XyZ/plan?proyectoId=pQr%E2%80%A6' \
  -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/projects/aBc123XyZ/plan?proyectoId=pQr%E2%80%A6');
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/projects/aBc123XyZ/plan?proyectoId=pQr%E2%80%A6', {
  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": {
        "proyectoId": "pQr…",
        "proyecto": "OB-12 Casa Bel",
        "inicio": "2026-11-09",
        "fin_previsto": "2026-12-04",
        "num_tareas": 2,
        "tareas_con_avisos": 1,
        "tareas": [
            {
                "tareaId": "sTu…",
                "titulo": "Estructura",
                "estado": "En curso",
                "progreso": 40,
                "fecha_inicio": "2026-11-09",
                "hora_inicio": null,
                "fecha_fin": "2026-11-20",
                "espera_a": null,
                "personas": [
                    {
                        "empleadoId": "aBc…",
                        "nombre": "Pere Mas"
                    }
                ],
                "avisos": []
            },
            {
                "tareaId": "vWx…",
                "titulo": "Cubierta",
                "estado": "Por hacer",
                "progreso": 0,
                "fecha_inicio": "2026-11-18",
                "hora_inicio": null,
                "fecha_fin": "2026-11-25",
                "espera_a": {
                    "tareaId": "sTu…",
                    "titulo": "Estructura",
                    "acaba": "2026-11-20"
                },
                "personas": [],
                "avisos": [
                    {
                        "tipo": "sin_asignar",
                        "texto": "No la tiene nadie"
                    },
                    {
                        "tipo": "antes_que_su_bloqueo",
                        "texto": "Empieza el 2026-11-18 y espera a «Estructura», que acaba el 2026-11-20"
                    }
                ]
            }
        ]
    }
}

Errores

CasoResultado
Sin credenciales errorCode 401.
El proyecto no es de tu cuenta errorCode 404.
Notas

Por MCP es plan_proyecto.