API & Automatisierung

onprop ist offen gebaut – du kannst deine Daten programmatisch anbinden und Workflows automatisieren.

Öffentliche API & API-Keys

In den Einstellungen → API-Keys erstellst du Schlüssel (pro Mandant, mit Scopes wie properties, units, tenants, loans, payments, tasks, documents – jeweils read/write). Der Klartext-Key wird einmalig angezeigt; Keys lassen sich rotieren und widerrufen.

Die öffentliche API liegt unter /api/v1/public/* und wird per X-API-Key bzw. Authorization: Bearer authentifiziert. Alle Zugriffe sind mandantengescoped und im Audit-Log nachvollziehbar.

MCP-Server

Über den MCP-Server können KI-Assistenten (z. B. Claude) deine onprop-Daten eigenständig pflegen – Objekte, Einheiten, Mieter, Darlehen, Zahlungen, Aufgaben, Dokumente (inkl. Upload/Extraktion) und Bewertungen anlegen, ändern und löschen. Authentifizierung läuft über die API-Keys; destruktive Aktionen sind klar gekennzeichnet.

Automatisierung (n8n & Make)

Die /public/*-API lässt sich direkt in n8n oder Make einbinden (CRUD über den HTTP-/Webhook-Knoten mit deinem API-Key). So reagierst du auf onprop-Ereignisse oder legst umgekehrt per Szenario Objekte/Aufgaben an.

API-Referenz (Swagger)

Die vollständige Endpunkt-Referenz findest du in der interaktiven Swagger-UI unter docs.onprop.io. Dort sind alle Endpunkte, Parameter, Scopes und Antwortschemata dokumentiert; der maschinenlesbare OpenAPI-Export liegt unter /api/docs-json.

Dieses Handbuch beschreibt die Bedienung der Plattform – die technische API-Referenz wird laufend aus dem Backend generiert und unter docs.onprop.io gepflegt.