Fehlerbehandlung

Die API verwendet Standard-HTTP-Statuscodes, um den Erfolg oder Misserfolg einer Anfrage anzuzeigen.

• 200 OK: Anfrage war erfolgreich. Der Antwortkörper enthält die angeforderten Daten oder GraphQL-Fehler, falls die Abfrage ungültig war.
• 400 Bad Request: Die Anfrage war fehlerhaft (z.B. ungültiges JSON, ungültige GraphQL-Abfragesyntax).
• 401 Unauthorized: API-Schlüssel fehlt.
• 403 Forbidden: API-Schlüssel ist ungültig, inaktiv, keinem Plan zugeordnet, der Plan ist inaktiv oder die Abfrage versucht, auf nicht zulässige Felder/Operationen zuzugreifen.
• 429 Too Many Requests: Sie haben Ihr API-Credit-Limit überschritten.
• 500 Internal Server Error: Auf unserem Server ist ein unerwarteter Fehler aufgetreten.

GraphQL-Fehler (auch bei einem HTTP-Status 200 OK) werden im errors-Array der JSON-Antwort enthalten sein:

{
  "errors": [
    {
      "message": "Cannot query field \"nonExistentField\" on type \"ProfessionalNode\".",
      "locations": [ { "line": 6, "column": 9 } ]
    }
  ]
}

Häufige GraphQL-Fehler & Lösungen

„Input contains extra keys [\\"args\\"]“

In diesem Schema werden Funktionsargumente direkt übergeben. Wenn Sie senden:

query {
  search_facilities(args: { p_name_pattern: "praxis%", p_limit: 10, p_offset: 0 }) {
    edges { node { id } }
  }
}

…kann dies fehlschlagen. Übergeben Sie Argumente stattdessen direkt:

query {
  search_facilities(p_name_pattern: "praxis%", p_limit: 10, p_offset: 0) {
    edges { node { id } }
  }
}

„unknown field in connection“

Viele set-returning Funktionen werden als Connection exponiert. Wenn Sie Felder direkt auf dem Rückgabewert abfragen, kann dieser Fehler auftreten. Nutzen Sie: edges { node { ... } }.

„...Filter contains additional keys [\\"locations\\"]“

Dies kann auftreten, wenn Sie eine Basistabelle nach Feldern einer Relation filtern (z. B. facilities nach Location-Feldern). Nutzen Sie in diesem Fall die Suchfunktionen wie search_facilities.

Support

Wenn Sie Fragen haben, auf Probleme stoßen oder Unterstützung benötigen, kontaktieren Sie bitte unser Support-Team unter support@arztapi.de oder besuchen Sie unsere Kontaktseite unter arztapi.de/kontakt.