FAQ
Wie rotiere ich einen API-Key?
Die Rotation erfolgt nach dem Blue/Green-Muster: Erstelle in den Portaleinstellungen einen neuen API-Key mit demselben Agentennamen und den gewünschten Scopes, hinterlege das neue Secret in deiner Anwendung und deaktiviere anschließend den alten Schlüssel. Das stellt einen unterbrechungsfreien Betrieb sicher. Siehe Key-Lebenszyklus.
Kann ich mehrere Keys unter einem Agenten gruppieren?
Aktuell wird jeder API-Key einzeln verwaltet. Eine logische Gruppierung mehrerer Keys pro Agent ist auf der Roadmap geplant. Im Audit-Log bleibt jeder Schlüssel bereits heute eindeutig seinem benannten Agenten zugeordnet.
Welche Berechtigungs-Scopes stehen zur Verfügung?
Berechtigungen unterscheiden zwischen reinem Lesezugriff (Queries), fachbezogenen Schreibrechten (Commands) und gesondert abgesicherten destruktiven Aktionen (Löschvorgänge). Eine Übersicht empfohlener Profile findest du unter Berechtigungs-Scopes.
In wessen Namen kann ein Agent handeln?
Keys können als user-gebunden (im Namen einer konkreten Mitarbeiterin oder eines Mitarbeiters) oder als tenant-gebunden (im Namen des gesamten Unternehmens) angelegt werden. Siehe Identität & Delegation.
Was passiert, wenn ein Agent versehentlich falsche Daten löscht?
Identifiziere den Aufruf im Audit-Log, sperre bei Bedarf den Key und stelle die Datensätze per Restore-Kommando wieder her. Löschungen auf etg24 sind standardmäßig Soft Deletes, sodass fehlerhafte Aktionen jederzeit vollständig reversibel sind. Siehe Soft Delete & Rollback.
Wie frage ich verfügbare Dokumenttypen ab?
Rufe den v2-Endpunkt GET /propertymanagement/v2/query/documents.typemappings auf. Er liefert die für dein Portal gültigen Dokumenttypen mit internen Node-Klassen und Zielkategorien. Veraltete Typen werden automatisch gefiltert. Siehe Dokumenttypen.
Ist die v1-API veraltet?
Ja. Die Property-Management-API v1 ist veraltet (deprecated) und wird am 01.01.2027 vollständig abgeschaltet. Neue Integrationen sollten direkt auf v2 aufsetzen. Siehe V1-Abschaltung.
Gibt es feste Rate Limits?
Aktuell gibt es keine starren Quoten pro Endpunkt. Die Plattform skaliert elastisch mit der Last. Bei außergewöhnlich umfangreichen Massenmigrationen oder Dauersynchronisationen bitten wir um kurze Vorababstimmung. Siehe Rate Limits.
Gibt es ein offizielles SDK?
Aktuell stellen wir kein sprachspezifisches SDK bereit. Du sprichst die REST-API direkt über Standard-HTTP-Clients an oder bindest Agenten über unseren Model Context Protocol (MCP) Server an. Direkt nutzbare Vorlagen für Python und Node.js findest du in den Code-Snippets.
Wie erhalten Softwareanbieter Zugang zur Partner-Integration?
Für Anbieter gibt es keine Selbstregistrierung. Prüfe unsere Onboarding-Kriterien und kontaktiere unser Team direkt wie unter Für Anbieter & Partner beschrieben – wir binden Partner in einem strukturierten Prozess an.
Wie erhalte ich MCP-Zugang?
Registriere dich als Kunde – die kostenlose Enterprise-Testphase beinhaltet vollen MCP-Zugriff. Erstelle einen Key, verbinde deinen MCP-Client (z. B. Claude Desktop, Cursor, VS Code) und starte mit Warum MCP bei etg24.
Welche Webhook-Events kann ich abonnieren?
Du kannst created-, updated- und deleted-Ereignisse für Liegenschaften, Einheiten, Kontakte und Dokumente abonnieren. Die aktuelle Liste liefert GET /propertymanagement/v2/query/webhooks.eventTypes. Details zur Einrichtung siehe Webhooks.
Welches Daten- und Transaktionsvolumen bewältigt die Plattform?
Die Plattform ist für Enterprise-Volumina ausgelegt – beispielsweise das Hochladen von mehr als 10.000 Dokumenten innerhalb einer Stunde. Bei sehr großen Datenübernahmen stimmen wir die Kapazitäten gerne vorab mit dir ab. Siehe Performance & Skalierung.