API pública de Adminia Manager: integrá tu administración con cualquier sistema

Hace un par de años, integrar tu software de consorcios con otra herramienta significaba pagar un desarrollo a medida, abrir tickets de soporte y rezar. Hoy, cualquier administración mediana necesita que sus datos viajen libremente: del sistema de expensas al estudio contable, del CRM al dashboard del directorio, de la plataforma de cobros al sistema de gestión documental.

Por eso Adminia Manager publica una **API REST v1 read-only** con API keys por organización. En 5 minutos podés generar una clave y empezar a consultar tus edificios, unidades, deuda, cobros y movimientos desde cualquier sistema externo. Y todo queda auditado en la plataforma.

Para qué sirve realmente una API en administración de consorcios

Una API es la forma estándar en que dos sistemas se hablan. En el mundo de los consorcios, esto significa que podés dejar de copiar y pegar datos entre planillas, mails y plataformas. Casos reales que vemos todas las semanas:

• **Estudio contable**: que el contador del consorcio descargue automáticamente los gastos del mes desde su software (Tango, Xubio, Holded) sin pedírselos al administrador.
• **Power BI / Looker Studio**: armar un tablero ejecutivo para el directorio del consorcio con datos en vivo.
• **CRM (HubSpot, Pipedrive)**: cuando entra un nuevo edificio, crear automáticamente el deal cerrado y un proyecto de onboarding.
• **Gestión documental** (Google Drive, Notion): sincronizar las liquidaciones publicadas como PDFs en una carpeta compartida con el consejo de administración.
• **Apps internas custom**: una administración grande puede armarse su propio panel para uso interno del equipo.
• **Bots de WhatsApp del consejo**: cuando un miembro del consejo pregunta '¿cuánto cobramos este mes?', un bot consulta la API y responde.

Cómo obtener tu API key (paso a paso)

1. Entrá a Adminia Manager con tu usuario administrador de organización.
2. Andá a **Configuración → Integraciones → API & Webhooks**.
3. Click en 'Generar nueva API key', asignale un nombre descriptivo (ej: 'Power BI directorio') y los scopes que necesita.
4. Copiá la key (se muestra una sola vez, guardala en un gestor de secretos).
5. La key arranca con `am_live_…` para producción.

Endpoints principales de la API v1

Base URL: `https://api.adminiamanager.com/v1`. Todos los endpoints requieren el header `Authorization: Bearer <API_KEY>` y devuelven JSON.

• `GET /buildings` — listar todos los edificios de tu organización.
• `GET /buildings/:id` — detalle de un edificio (datos legales, CUIT, mandato).
• `GET /buildings/:id/units` — todas las unidades funcionales con coeficientes.
• `GET /buildings/:id/expenses?from=&to=` — gastos del edificio en un rango.
• `GET /buildings/:id/collections?from=&to=` — cobros recibidos en un rango.
• `GET /buildings/:id/debt` — deuda actual agrupada por unidad.
• `GET /buildings/:id/liquidations` — liquidaciones publicadas con totales por coeficiente.
• `GET /units/:id/ledger` — mayor individual de una unidad (débitos y créditos).

Ejemplo en cURL: listar edificios

Probalo desde tu terminal sin escribir código:

• `curl -H 'Authorization: Bearer am_live_xxx' https://api.adminiamanager.com/v1/buildings`

La respuesta es un array JSON con `id`, `name`, `address`, `cuit`, `active_period` y `total_units` por cada edificio.

Ejemplo en Node.js: tablero de deuda por edificio

Imaginá que querés un script semanal que mande al directorio el ranking de edificios con más deuda. En 20 líneas de JavaScript lo tenés:

• Hacés `fetch` a `/buildings`, iterás cada edificio y consultás `/buildings/:id/debt`.
• Sumás `total_debt` y ordenás de mayor a menor.
• Mandás el resultado por email con un servicio como Resend o por WhatsApp con Twilio.
• Lo programás con cron, Vercel Cron o GitHub Actions, y listo: tablero semanal sin abrir Adminia.

Buenas prácticas y límites

• **Rate limit**: 60 requests/minuto por API key. Si necesitás más, escribinos.
• **Rotación**: rotá la API key cada 90 días o si sospechás que se filtró.
• **Scopes mínimos**: si solo necesitás deuda, no le des scope de cobros.
• **Audit log**: cada llamada queda registrada con timestamp, IP y endpoint en la sección de auditoría de tu organización.
• **No expongas la key en el navegador**: usala siempre desde un backend o función serverless.

Preguntas frecuentes