FAQ
Wie rotiere ich einen API-Key?
Es gibt keinen Rotation-Endpoint. Rotation heißt: neuen Key mit demselben Agentennamen erstellen, den Agenten umstellen, den alten Key deaktivieren. Siehe Key-Lebenszyklus.
Kann ich mehrere Keys unter einem Agenten gruppieren?
Heute nicht. Keys werden einzeln verwaltet; die Gruppierung pro Agent ist auf der Roadmap. Jeder Key bleibt trotzdem einzeln seinem Agenten zuordenbar.
Welche Berechtigungs-Scopes gibt es?
Read-only (nur Queries), Schreibzugriff begrenzt auf bestimmte Fähigkeiten, destruktive Aktionen separat gesteuert. Lies Berechtigungs-Scopes für das vollständige Bild.
In wessen Namen kann ein Agent handeln?
Im Namen einer Person (eines Mitarbeiters) oder im Namen des Unternehmens selbst – gewählt bei der Key-Erstellung. Anders gesagt: Keys sind user-gebunden oder tenant-gebunden. Siehe Identität & Delegation.
Was passiert, wenn ein Agent falsche Daten löscht?
Die Änderung im Log finden, den Agenten-Key bei Bedarf deaktivieren und zurückrollen. Löschungen sind fast überall Soft Deletes, Agenten-Fehler sind also reversibel. Siehe Rollback.
Wie bekomme ich die verfügbaren Dokumenttypen?
Frage den V2-Endpoint GET /propertymanagement/v2/query/documents.typemappings ab. Er liefert die für dein Portal gültigen Dokumenttypen mit ihren Node-Typen und Kategorien – veraltete Typen sind ausgeschlossen. Siehe Dokumenttypen.
Ist die V1-API veraltet?
Ja. Die Property-Management-API V1 ist veraltet (deprecated) und wird am 01.01.2027 abgeschaltet. Migriere deine Integration rechtzeitig auf V2. Siehe V1-Abschaltung.
Gibt es Rate Limits?
Es gibt heute keine festen Quoten pro Endpoint. Die Plattform ist für hohe Volumen gebaut. Planst du eine Massenmigration oder High-Volume-Automatisierung, kontaktiere uns vorher – Limits können künftig selektiv gelten. Siehe Rate Limits.
Gibt es ein SDK?
Nein, heute gibt es kein SDK – du nutzt die HTTP-API direkt und für Agenten den MCP-Server. Kopiere aus den Code-Snippets, um loszulegen.
Wie bekommen Anbieter eine Integration?
Anbieter registrieren sich nicht selbst. Kontaktiere uns mit der Checkliste aus Für Anbieter & Partner – wir onboarden Partner über einen strukturierten Integrationsprozess.
Wie bekomme ich MCP-Zugang?
Melde dich als Kunde an – die kostenlose Enterprise-Stufe umfasst den MCP-Zugang. Key erstellen, MCP-Client verbinden und mit Warum MCP bei etg24 starten.
Welche Webhook-Events kann ich abonnieren?
Created-, Updated- und Deleted-Events über die zentralen Entitätstypen – darunter Objekte, Einheiten und Kontakte. Der Katalog wächst mit der Plattform: Frag die aktuelle Liste über GET /propertymanagement/v2/query/webhooks.eventTypes ab, Einrichtung siehe Webhooks.
Wie viel Volumen verträgt die Plattform?
Sie ist für hohe Volumen gebaut – z. B. das Hochladen von rund 10.000 Dokumenten innerhalb einer Stunde. Bei großen Lasten kontaktiere uns, damit wir den Plan bestätigen können. Siehe Performance & Skalierung.