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

Tareas de proyecto

GET https://api.afer.pro/api/v1/tasks
Alias en castellano (v0, sigue operativo): POST https://api.afer.pro/consultarTareas

Las tareas de obra con su proyecto, su estado, su responsable y su progreso.

El detalle del bloque tareas que resume obtenerProyecto. Se excluyen siempre las tareas eliminadas.

Una tarea está vencida cuando no llega al 100 % y su fecha prevista de fin ya ha pasado — mismo criterio que el cuadro de mandos interno. Con vencidas: true se listan solo esas, que es la consulta útil para una alerta diaria.

Si envías fechas, el filtro es por solape: entra toda tarea viva en algún momento del período, no solo las que empiezan y acaban dentro.

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 con API key: sin credenciales responde 401.

Parámetros del cuerpo

El cuerpo de la petición es un objeto JSON con Content-Type: application/json.

proyectoIdstring
opcional
Solo las tareas de este proyecto.
estadoIdstring
opcional
Solo las tareas en este estado. Los identificadores salen de consultarEstados.
fecha_iniciodate
opcional
Tareas vivas a partir de esta fecha. Formato YYYY-MM-DD.
fecha_findate
opcional
Tareas vivas hasta esta fecha.
vencidasbool
opcional
Con true, solo las tareas vencidas.
paginaint
opcional
Página a devolver. Por defecto 1.
por_paginaint
opcional
Resultados por página. Por defecto 100, máximo 500.

Ejemplo de petición

curl -X GET 'https://api.afer.pro/api/v1/tasks?vencidas=1' \
  -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/tasks?vencidas=1');
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/tasks?vencidas=1', {
  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": {
        "total_tareas": 1,
        "pagina": 1,
        "por_pagina": 100,
        "num_paginas": 1,
        "tareas": [
            {
                "tareaId": "tSk44…",
                "titulo": "Instalación eléctrica planta baja",
                "proyecto": {
                    "proyectoId": "aBc123XyZ…",
                    "numero": "OB-2026-07",
                    "descripcion": "Reforma integral local Palma"
                },
                "estado": {
                    "estadoId": "eSt3…",
                    "titulo": "En curso"
                },
                "responsable": {
                    "empleadoId": "eMp001…",
                    "nombre": "Ana",
                    "apellidos": "Pons Ferrer"
                },
                "fecha_inicio": "2026-04-08",
                "fecha_prevista_fin": "2026-05-02",
                "progreso": 70,
                "vencida": true,
                "importe_presupuestado": 8400
            }
        ]
    }
}
Notas