← FlatKeeper

API dokumentáció (v1)

Csak olvasható REST API az Ingatlankezelő csomaghoz – könyvelői exporthoz, saját riportokhoz, integrációkhoz.

Hitelesítés

API kulcsot a Fiók beállítások → API hozzáférés alatt hozhatsz létre. A kulcsot csak létrehozáskor látod; mi csak a hash-ét tároljuk.

curl -H "Authorization: Bearer fk_live_…" \
  "https://www.flatkeeper.eu/api/v1/payments?month=2026-10&limit=50"

Végpontok

GETTartalomSzűrők
/api/v1/propertiesIngatlanok–
/api/v1/tenantsBérlőkproperty_id
/api/v1/paymentsBefizetésekproperty_id, month=YYYY-MM
/api/v1/meter-readingsMérőállásokproperty_id, from=YYYY-MM-DD
/api/v1/invoicesBillingo számlákproperty_id, month=YYYY-MM

Minden végpont: ?limit= (1–1000, alap 100) és ?offset=. Válasz: { data: [...], pagination: { limit, offset, total } }

Hibakódok

  • 401 – hiányzó, hibás vagy visszavont kulcs
  • 403 – a csomag nem tartalmaz API hozzáférést
  • 400 – hibás szűrőparaméter
  • 404 – ismeretlen erőforrás