Plan de un proyecto
https://api.afer.pro/api/v1/projects/{id}/plan
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.
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.
proyectoIdstringobligatorio | 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
{
"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
| Caso | Resultado |
|---|---|
| Sin credenciales | errorCode 401. |
| El proyecto no es de tu cuenta | errorCode 404. |
Por MCP es plan_proyecto.