Fehlercodes

Jeder Code, den die API nach außen gibt, mit seiner Bedeutung. Erzeugt aus dem Verzeichnis, gegen das die API selbst getippt ist.

Jeder Fehler hat dieselbe Form:

{ "error": "rate_limited" }

Der Code ist eine Kennung für eine Verzweigung in deinem Programm, kein Satz für einen Menschen. Es gibt genau einen Code je Bedeutung, und keiner verschwindet still: die API darf nur Codes aus diesem Verzeichnis ausgeben. Verzweige auf den Code, nie auf den HTTP-Status allein; ein unbekannter Code ist ein Fall für deine allgemeine Meldung.

Anmeldung und Konto

Code	Bedeutung
`account_exists`	Zu dieser Adresse gibt es schon ein Konto.
`no_account`	Zu dieser Adresse gibt es kein Konto.
`anmeldung_pausiert`	Der Betriebsschalter steht auf Pause.
`keine_freigabe`	Die Anmeldung ist pausiert, und für diese Adresse gibt es keine Freigabe.
`konto_pruefung_fehlt`	Die Kontoprüfung war nicht erreichbar.
`wegwerf_adresse`	Eine Wegwerfadresse. An sie kommt keine Antwort an.
`adresse_unzustellbar`	Die Domain der Adresse nimmt keine Post an: es gibt sie nicht, oder sie hat keinen Mailserver.
`invalid_code`	Der eingegebene Code stimmt nicht.
`unauthorized`	Keine gültige Sitzung.
`forbidden`	Angemeldet, aber nicht berechtigt.
`schluessel_recht_fehlt`	Der API-Schlüssel darf hier nicht schreiben: außerhalb des MCP-Servers schreibt nur ein Schlüssel mit dem Recht freigeben.
`verbindung_ungueltig`	Die Zustimmung zu einer Verbindung ist abgelaufen, verändert, gehört zu keinem bekannten Client oder mischt die Rechte beider Seiten.
`seite_fehlt`	Eine Verbindung als Anbieter braucht ein Konto, das die Anbieterseite eingerichtet hat.
`contact_missing`	Zur Sitzung gibt es keinen Kontakt.
`confirmation_mismatch`	Die Bestätigung stimmt nicht mit der Vorgabe überein.

Freigabeliste (Panel)

Code	Bedeutung
`freigabe_vorhanden`	Für diese Adresse oder Domain gilt schon eine Freigabe.
`domain_zu_breit`	Eine Domain eines Mailanbieters lässt sich nicht freigeben, nur einzelne Adressen darauf.

Form der Anfrage

Code	Bedeutung
`invalid_body`	Der Rumpf passt nicht zum Schema.
`invalid_query`	Die Abfrageparameter passen nicht zum Schema.
`invalid_id`	Die Kennung ist keine gültige Kennung.
`invalid_input`	Die Eingabe passt nicht.
`query_required`	Es fehlt die Suchabfrage.
`no_fields`	Es wurde kein einziges Feld geschickt.
`unknown_key`	Der Schlüssel ist unbekannt.
`missing_property_id`	Es fehlt die Kennung der Immobilie.
`payload_too_large`	Der Rumpf oder die Datei ist größer als erlaubt.
`not_found`	Es gibt nichts unter dieser Kennung.

Drossel

Code	Bedeutung
`rate_limited`	Zu viele Anfragen in zu kurzer Zeit.

Dateien

Code	Bedeutung
`datei_fehlt`	Es war keine Datei dabei.
`invalid_attachment`	Der Anhang ist nicht erlaubt.
`typ_nicht_erlaubt`	Dieser Dateityp ist nicht erlaubt.
`typ_stimmt_nicht`	Der Inhalt der Datei passt nicht zu ihrem Typ.
`zu_viele`	Mehr Dateien, als erlaubt sind.
`zu_gross_gesamt`	Die Dateien zusammen sind größer als erlaubt.
`kein_xml`	Die Datei ist kein XML.
`kein_openimmo`	Das XML ist kein OpenImmo.
`kaputt`	Die Datei ließ sich nicht lesen.
`leer`	Die Datei oder der Wurf enthält nichts.
`unbekanntes_fach`	Dieses Fach der Ablage gibt es nicht.
`datei_nicht_abrufbar`	Die Datei ließ sich unter der genannten Adresse nicht abrufen.

Tarif und Bezahlung

Code	Bedeutung
`payment_required`	Ohne Bezahlung geht es hier nicht weiter.
`plan_required`	Der Tarif enthält diese Leistung nicht.
`tarif_zu_klein`	Der Tarif enthält diese Leistung nicht (Anbieterseite).
`quota_exceeded`	Die Grenze des Tarifs ist erreicht (Suchende).
`mandate_limit`	Mehr Suchaufträge, als der Tarif erlaubt.
`abo_vorhanden`	Es läuft schon ein Abo.
`zustimmung_fehlt`	Es fehlt die Zustimmung zu AGB und AV-Vertrag in ihrer aktuellen Fassung.
`kein_wechsel`	Ein Wechsel auf denselben Tarif ist keiner.
`no_customer`	Zu diesem Konto gibt es keinen Kunden bei Stripe.
`plan_not_configured`	Zu diesem Tarif ist kein Preis hinterlegt.
`billing_not_configured`	Die Bezahlung ist nicht eingerichtet.
`billing_unavailable`	Der Bezahldienst antwortet nicht.
`verkauf_pausiert`	Der Verkauf ist vom Betrieb pausiert.
`kuendigung_fehlgeschlagen`	Die Kündigung ging nicht durch.
`kein_abo`	Zu diesem Konto läuft kein Abo.
`nicht_gekuendigt`	Es liegt keine Kündigung vor, die sich zurücknehmen ließe.
`maklervertrag_offen`	Es läuft noch ein Maklervertrag.

Suchauftrag

Code	Bedeutung
`mandate_conflict`	Der Suchauftrag widerspricht einem bestehenden.
`mandate_incomplete`	Dem Suchauftrag fehlen Pflichtangaben.
`no_active_mandate`	Es gibt keinen laufenden Suchauftrag.
`send_failed`	Die Sendung ging nicht raus.
`claim_not_stored`	Der Anspruch wurde nicht hinterlegt.
`schon_angefragt`	Zu dieser Immobilie gibt es schon eine Anfrage.
`kein_uebergang`	Der Treffer steht inzwischen anders; die Entscheidung führt von dort nirgends hin.

Inserat und Objekt

Code	Bedeutung
`unvollstaendig`	Dem Inserat fehlen Pflichtangaben.
`inserat_abgeschlossen`	Die Immobilie ist verkauft oder vermietet.
`inserat_reserviert`	Die Immobilie ist reserviert.
`inserat_gesperrt`	Das Inserat ist gesperrt.
`kuerzel_vergeben`	Das Kürzel hat schon jemand.
`keine_adresse`	Es fehlt die Anschrift.
`adresse_vergeben`	Zu dieser Anschrift gibt es schon eine Immobilie.
`eigene_adresse`	Die eigene Adresse lässt sich nicht einladen.
`schon_eingeladen`	Diese Person ist schon eingeladen.
`entwurf_leer`	Der Entwurf kam leer zurück.
`entwurf_fehlgeschlagen`	Der Entwurf ließ sich nicht erzeugen.
`versand_fehlgeschlagen`	Der Versand ging nicht durch.
`zu_wenig`	Zu wenig Material für diesen Schritt.
`seller_disabled`	Die Anbieterseite ist abgeschaltet.
`abruf`	Der Abruf beim fremden System schlug fehl.
`abgeschlossen`	Der Vorgang ist abgeschlossen und nicht mehr zu ändern.
`inserat_aktiv`	Die Immobilie ist noch inseriert.
`nicht_online`	Das Inserat läuft gerade nicht.
`beispielobjekt`	Die Immobilie ist ein erfundenes Beispielobjekt; an sie geht keine Anfrage.
`impressum_fehlt`	Ein gewerblicher Anbieter braucht ein hinterlegtes Impressum, bevor seine Objekte in ChatGPT und Claude erscheinen.

Anfrage ohne Konto

Code	Bedeutung
`einwilligung_fehlt`	Es fehlt die ausdrückliche Einwilligung in die Weitergabe der Anfrage an den Anbieter, in ihrer aktuellen Fassung.

CRM

Code	Bedeutung
`email_vergeben`	Zu dieser Mailadresse gibt es in diesem Büro schon einen Kontakt.
`name_vergeben`	Eine Liste dieser Art trägt den Namen schon.

Anbindungen an fremde Systeme

Code	Bedeutung
`geheimnis_nicht_eingerichtet`	Zugangsdaten lassen sich gerade nicht sicher ablegen.
`anbindung_nicht_gespeichert`	Die Anbindung ließ sich nicht speichern.
`schluessel_falsch`	Das fremde System lehnt die Zugangsdaten ab.
`keine_berechtigung`	Die Zugangsdaten gelten, dürfen aber keine Objekte lesen.
`nicht_erreichbar`	Das fremde System war nicht erreichbar.
`quelle_drosselt`	Das fremde System nimmt gerade keine weiteren Anfragen an.
`quelle_abgewiesen`	Das fremde System hat die Anfrage abgewiesen.
`quelle_unlesbar`	Das fremde System hat etwas geantwortet, das sich nicht lesen lässt.
`zielfeld_unbekannt`	Dieses Zielfeld gibt es nicht.
`lauf_nicht_zuruecknehmbar`	Dieser Lauf lässt sich nicht zurücknehmen.
`lauf_laeuft`	Für diese Anbindung läuft schon ein Lauf.
`lauf_beendet`	Dieser Lauf ist schon beendet.

Hintergrundaufgaben (Panel)

Code	Bedeutung
`job_nicht_fehlgeschlagen`	Dieser Job ist nicht (mehr) fehlgeschlagen.

Der Agent im Hintergrund

Code	Bedeutung
`vorschlag_entschieden`	Über diesen Vorschlag ist schon entschieden: angenommen, verworfen oder verfallen.
`bestaetigung_noetig`	Diese Handlung führt erst der Klick eines Menschen aus, in der Karte des Assistenten oder in der App.
`bestaetigung_abgelaufen`	Die Bestätigung ist abgelaufen; die Handlung muss neu vorbereitet werden.
`stufe_aus`	Das Büro hat diese Art von Handlung in der Automatik abgeschaltet; nichts wird vorbereitet.
`wert_geaendert`	Der Wert wurde seit der Änderung des Agenten wieder geändert; zurücksetzen ginge über diese hinweg.
`schon_rueckgaengig`	Diese Änderung des Agenten ist schon zurückgenommen.

Besichtigung

Code	Bedeutung
`voll`	Der Termin ist belegt.
`vorbei`	Der Zeitpunkt liegt in der Vergangenheit.
`schon_gebucht`	Es gibt schon eine Buchung dieser Person.
`kalender_belegt`	Der Anbieter hat zu dieser Zeit schon einen anderen Termin.
`kalender_nicht_eingerichtet`	Dieser Kalender-Anbieter ist bei uns nicht eingerichtet.

Soziale Netze

Code	Bedeutung
`social_nicht_eingerichtet`	Die Anbindung an die sozialen Netze ist bei uns nicht eingerichtet.
`social_kein_konto`	Das Büro hat in keinem passenden Netz ein verbundenes Konto.
`social_vorlage_noetig`	Das Antwortfenster des Kanals ist zu; eine Antwort ginge nur noch als freigegebene Vorlage hinaus.
`werbekonto_fehlt`	Die Einrichtung der Anzeigen ist nicht fertig; es fehlt das Werbekonto oder ein Schritt dazu.
`monatsbudget_erschoepft`	Das freigegebene Monatsbudget für Anzeigen reicht dafür nicht mehr.

Bewertung

Code	Bedeutung
`unsupported_property_type`	Für diese Objektart gibt es keine Bewertung.
`bewertung_fertig`	Die Bewertung ist fertig; eine Annahme ändert man in einer neuen Bewertung.
`unbekannte_annahme`	Eine Annahme mit diesem Schlüssel gibt es nicht.
`bewertung_nicht_fertig`	Die Bewertung ist noch ein Entwurf; einen Bericht für den Eigentümer gibt es erst, wenn sie fertig ist.
`bewertung_ohne_spanne`	Die Bewertung hat keine Spanne; ohne Wert gibt es keinen Bericht für den Eigentümer.
`annahme_von_hand`	Ein Mensch hat diese Annahme gesetzt; ein ausgelesener Wert ersetzt sie nicht.
`incomplete`	Für eine Bewertung fehlen Angaben.
`ambiguous`	Die Angabe ist nicht eindeutig.

Zustellwege fremder Systeme

Code	Bedeutung
`missing_signature`	Es fehlt die Signatur.
`invalid_signature`	Die Signatur von Stripe stimmt nicht.
`bad_payload`	Der Rumpf des Zustellwegs passt nicht.
`bad_signature`	Die Signatur des Zustellwegs stimmt nicht.
`retry_later`	Später noch einmal versuchen.

Der Rest

Code	Bedeutung
`tool_failed`	Das Werkzeug des Agenten schlug fehl.
`internal_error`	Ein Fehler, für den es keinen eigenen Code gibt.

Anmeldung und KontoLink zu diesem Abschnitt kopieren

Freigabeliste (Panel)Link zu diesem Abschnitt kopieren

Form der AnfrageLink zu diesem Abschnitt kopieren

DrosselLink zu diesem Abschnitt kopieren

DateienLink zu diesem Abschnitt kopieren

Tarif und BezahlungLink zu diesem Abschnitt kopieren

SuchauftragLink zu diesem Abschnitt kopieren

Inserat und ObjektLink zu diesem Abschnitt kopieren

Anfrage ohne KontoLink zu diesem Abschnitt kopieren

CRMLink zu diesem Abschnitt kopieren

Anbindungen an fremde SystemeLink zu diesem Abschnitt kopieren

Hintergrundaufgaben (Panel)Link zu diesem Abschnitt kopieren

Der Agent im HintergrundLink zu diesem Abschnitt kopieren

BesichtigungLink zu diesem Abschnitt kopieren

Soziale NetzeLink zu diesem Abschnitt kopieren

BewertungLink zu diesem Abschnitt kopieren

Zustellwege fremder SystemeLink zu diesem Abschnitt kopieren

Der RestLink zu diesem Abschnitt kopieren

Auf dieser Seite