Fehlerbehandlung

Verstehen Sie die SEO Boost Hub API-Fehlerantworten, damit Ihre Integration stabil auf Fehler reagieren kann.

Fehlerantwort-Format

Alle Fehlerantworten folgen einer konsistenten JSON-Struktur:

{
  "error": {
    "code": "resource_not_found",
    "message": "The requested location could not be found.",
    "details": {
      "resource": "location",
      "id": "loc_invalid123"
    }
  }
}

HTTP-Statuscodes

Statuscode	Bedeutung	Beschreibung
`400`	Bad Request	Die Anfrage war fehlerhaft oder es fehlten erforderliche Felder.
`401`	Unauthorized	Authentifizierung fehlgeschlagen. Überprüfen Sie Ihren API-Schlüssel.
`403`	Forbidden	Ihr API-Schlüssel verfügt nicht über den erforderlichen Bereich für diese Aktion.
`404`	Not Found	Die angeforderte Ressource existiert nicht.
`409`	Conflict	Ein Ressourcenkonflikt ist aufgetreten (z.B. doppelter Eintrag).
`422`	Unprocessable Entity	Validierung fehlgeschlagen. Überprüfen Sie das errors-Array für Details.
`429`	Too Many Requests	Zu viele Anfragen. Verlangsamen Sie und versuchen Sie es nach dem Reset-Fenster erneut.
`500`	Internal Server Error	Ein unerwarteter Serverfehler ist aufgetreten. Kontaktieren Sie den Support, wenn es anhält.

Validierungsfehler

Wenn eine 422-Antwort zurückgegeben wird, enthält das Fehlerobjekt ein details-Array mit feldspezifischen Validierungsnachrichten:

{
  "error": {
    "code": "validation_error",
    "message": "The given data was invalid.",
    "details": {
      "name": [
        "The name field is required."
      ],
      "city": [
        "The city field is required.",
        "The city must be a string."
      ],
      "country": [
        "The country must be a valid ISO 3166-1 alpha-2 code."
      ]
    }
  }
}

Fehlercodes

Die folgenden anwendungsspezifischen Fehlercodes können im code-Feld erscheinen:

Code	Beschreibung
`authentication_failed`	Authentifizierungsdaten fehlen oder sind ungültig
`insufficient_permissions`	Unzureichende Berechtigungen für die angeforderte Aktion
`resource_not_found`	Die angeforderte Ressource wurde nicht gefunden
`resource_conflict`	Ressource existiert bereits oder steht im Konflikt mit dem aktuellen Zustand
`validation_error`	Anfragekörper hat die Validierungsregeln nicht bestanden
`rate_limit_exceeded`	Rate-Limit für Ihren aktuellen Plan überschritten
`internal_error`	Ein unerwarteter serverseitiger Fehler ist aufgetreten