Skip to main content

​
Bedeutung

Die Anfrage war syntaktisch oder semantisch ungültig: ein fehlerhafter Body, ein fehlendes Pflichtfeld oder ein Parameterwert außerhalb des zulässigen Bereichs. Lässt sich das Problem einem einzelnen Parameter zuordnen, wird dieser im Feld param benannt. Eine Antwort mit 409 bedeutet, dass die Anfrage im Widerspruch zum aktuellen Ressourcenstatus steht. So kann beispielsweise die Erstellung eines OAuth-Clients fehlschlagen, weil das Ziel-Servicekonto inaktiv ist, eine angeforderte Berechtigung nicht besitzt oder das Client-Limit erreicht hat. Prüfen Sie status und detail gemeinsam; anhand des Fehlercodes allein lassen sich diese Fälle nicht von einer fehlerhaften Anfrage unterscheiden.

​
Was zu tun ist

  • Lesen Sie detail und param – sie beschreiben genau, was bei der Validierung fehlgeschlagen ist.
  • Korrigieren Sie bei 400 die Anfrage, bevor Sie sie erneut senden.
  • Beheben Sie bei 409 zunächst den Konflikt bei Kontostatus, Berechtigung oder Kapazität. Ein OAuth-Client, der auf die Bereinigung wartet, belegt weiterhin Kapazität. Behalten Sie den Retry-Schlüssel bei, wenn Sie denselben Erstellungsversuch nach der Behebung des Konflikts wiederholen.
  • Prüfen Sie in der API-Referenz die erforderlichen Felder, Typen und zulässigen Werte des Vorgangs.