Fehlercodes der API: was jeder Code bedeutet
Jeder Code, den die REST-API im Mitglied code eines Problems liefert, mit HTTP-Status und Bedeutung. Aus dem Vertrag erzeugt.
Zuletzt aktualisiert:
Jeder Code, den /v1 liefert, steht hier mit Status und Bedeutung. Ein Problem der REST-API nennt seinen Code in code und verweist mit type auf die Zeile des Codes hier. Der Code ist eine Kennung für eine Verzweigung in deinem Programm, kein Satz für einen Menschen. Es gibt genau einen je Bedeutung. Verzweige auf den Code, nie auf den HTTP-Status allein, und behandle einen Code, den du nicht kennst, über seinen Status. Das Format steht unter Fehler. Die Codes der App und der MCP-Server gelten nicht für /v1 und stehen auf der Seite Fehlercodes von App und MCP.
| Code | Status | Bedeutung |
|---|---|---|
address_already_exists | 409 | Ein Inserat mit dieser Adresse und Wohnung gibt es im Büro schon; die Antwort nennt es. Ändere es mit PATCH oder PUT, oder schicke eine data.location.unit, die beide unterscheidet. |
address_missing | 409 | Die anfragende Person ist über Athaus nicht erreichbar: kein Konto und keine E-Mail-Adresse. |
api_version_unsupported | 400 | Der Kopf Athaus-Version nennt eine Version, die es nicht gibt. Sende v1 oder lass den Kopf weg. |
automation_disabled | 409 | Das Büro hat diese Art Nachricht in seiner Automatik ausgeschaltet. Es wird nichts vorbereitet. |
503 | Der Zahlungsdienst antwortet nicht. Versuche es später noch einmal. | |
brokerage_agreement_active | 409 | Für das Inserat läuft noch ein Maklervertrag. Es lässt sich nicht löschen. |
email_already_exists | 409 | Das Büro hat schon einen Kontakt mit dieser E-Mail-Adresse. |
email_consent_missing | 409 | Der Kontakt hat der E-Mail nicht zugestimmt. Diese Nachricht geht nicht hinaus. |
email_opted_out | 409 | Der Kontakt hat der E-Mail widersprochen. Diese Nachricht geht nicht hinaus. |
forbidden | 403 | Der Key ist gültig, aber dafür nicht berechtigt. |
idempotency_key_in_use | 409 | Die erste Anfrage mit diesem Idempotency-Key läuft noch. Warte die Zeit aus Retry-After ab und sende dieselbe Anfrage noch einmal. |
idempotency_key_missing | 400 | Die Operation verlangt den Kopf Idempotency-Key, und die Anfrage hat keinen. |
idempotency_key_reused | 422 | Der Idempotency-Key wurde schon mit einem anderen Rumpf benutzt. Nimm für eine neue Anfrage einen neuen Key. |
idempotency_outcome_unknown | 409 | Die erste Anfrage mit diesem Key brach mitten in der Arbeit ab, niemand weiß, ob etwas geschrieben wurde. Sieh nach, was da ist, und wiederhole mit einem neuen Key. |
insufficient_permissions | 403 | Dem Key fehlt der Scope oder die Stufe auf der Ressource, die die Operation braucht. |
internal_error | 500 | Ein Fehler auf unserer Seite. Nenne dem Support die Request-Id. |
invalid_body | 400 | Der Rumpf passt nicht zum Schema. errors nennt jedes Feld einzeln. |
invalid_id | 400 | Eine Id im Pfad ist keine gültige Id. |
invalid_input | 400, 415 | Eine andere Eingabe ist ungültig, zum Beispiel ein nicht lesbarer Kopf If-Match oder ein Rumpf, der kein JSON ist (415). |
invalid_query | 400 | Die Abfrageparameter passen nicht zum Schema. |
listing_active | 409 | Das Inserat ist noch veröffentlicht und lässt sich nicht löschen. |
listing_blocked | 409 | Athaus hat das Inserat gesperrt. Das hebt ein Key nicht auf. |
listing_closed | 409 | Das Objekt ist verkauft oder vermietet und geht nicht wieder online. |
listing_incomplete | 409 | Dem Inserat fehlen Angaben für die Veröffentlichung. errors nennt, was fehlt. |
listing_not_online | 409 | Das Inserat läuft gerade nicht, also gibt es nichts zurückzunehmen. |
listing_not_unit | 409 | Das Inserat gehört zu keinem Neubauprojekt, also hat es keinen Stand einer Einheit. Ordne es mit POST /projects/\{externalProjectId\}/assign einem Projekt zu. |
listing_reserved | 409 | Das Objekt ist reserviert. Erst die Reservierung aufheben, dann veröffentlichen. |
mailbox_not_connected | 409 | Es ist kein Postfach verbunden. Eine Antwort geht nur aus dem Postfach des Büros hinaus. |
method_not_allowed | 405 | Den Pfad gibt es, aber nicht für diese Methode. Der Kopf Allow nennt die Methoden, die gehen. |
not_found | 404 | Unter dieser Id oder Adresse gibt es nichts, oder es gehört einem anderen Büro. |
payload_too_large | 413 | Der Rumpf ist größer als 512 KB, die Datei bei POST /v1/medias größer als 25 MB, oder das Inserat nähme mehr als 40 Dateien oder 500 MB auf, oder im Büro warten schon 200 Dateien auf ein Inserat. |
plan_required | 403 | Der Tarif des Büros enthält keinen API-Zugang. |
precondition_failed | 412 | Die Bedingung aus If-Match oder If-None-Match trifft nicht zu. Lies die Ressource neu und wiederhole mit ihrem neuen ETag. |
profile_unsupported | 400 | Die Anfrage hat einen Abschnitt countrySpecific für ein Land, für das es noch kein Profil gibt. |
project_not_empty | 409 | Das Projekt hat noch Einheiten und lässt sich nicht löschen. Löse sie zuerst mit POST /projects/\{externalProjectId\}/unassign oder lösche die Inserate. |
project_unit_limit_exceeded | 409 | Ein Projekt hat höchstens 1000 Einheiten, und dieser Aufruf würde es darüber bringen. Die Antwort nennt, wie viele es hat und wie viele dazukämen; nichts wurde geändert. Lege ein zweites Projekt an oder löse Einheiten mit POST /projects/\{externalProjectId\}/unassign. |
proposal_already_decided | 409 | Der Vorschlag ist schon freigegeben, abgelehnt oder abgelaufen. |
rate_limited | 429 | Zu viele Anfragen. Warte die Zeit aus Retry-After ab. |
reference_already_exists | 409 | Diese Referenz gehört im Büro schon zu etwas anderem: offererMarketingKey zu einem anderen Inserat, externalMediaId zu einer Datei, die auf ein Inserat wartet. |
test_office_busy | 409 | Das Testbüro wird gerade aufgebaut oder zurückgesetzt. Versuche es in ein paar Sekunden noch einmal. |
test_office_full | 403 | Das Testbüro ist voll. Lösche Daten oder setze es zurück. |
401 | Der Key fehlt, ist ungültig oder widerrufen. | |
unit_already_exists | 409 | Die Einheitsnummer gibt es im Projekt schon. errors nennt jede betroffene Einheit mit ihrer Stelle im Rumpf; nichts wurde angelegt. |
unit_status_invalid | 409 | Dieser Stand passt nicht zur Vermarktungsart des Projekts: ein Mietprojekt kennt rented, ein Kaufprojekt sold. |
upcoming_viewings_exist | 409 | Das Inserat hat anstehende Besichtigungen. Beim Löschen würden sie abgesagt. |
webhook_endpoint_limit_exceeded | 409 | Das Büro hat die höchste Zahl an Webhook-Endpunkten erreicht. |
Weiter lesen
REST-API: Fehler als Problem Details
Jeder Fehler von /v1 ist ein Problem nach RFC 9457 mit echtem HTTP-Status, einem Code zum Verzweigen und einer Request-Id für den Support.
REST-API: Limits und Drossel
Wie viele Aufrufe /v1 je Schlüssel und je Büro annimmt, welche Köpfe den Stand zeigen und was bei einem 429 zu tun ist.
Fehlercodes von App und MCP: was jeder Code bedeutet
Jeder Code, den die App und die MCP-Server nach außen geben, mit seiner Bedeutung. Erzeugt aus dem Verzeichnis, gegen das sie getippt sind.