FAQ

Als Response bei einer Suche kommt der HTTP-Statuscode 200 OK zurück, aber das Bundle mit den Suchergebnissen enthält keine Einträge. Woran liegt das und was ist zu tun?

Ursache: Der Request an sich ist valide und konnte auch erfolgreich verarbeitet werden. Im 116117 Terminservice sind jedoch keine Ressourcen vorhanden, die zurückgegeben werden können.

  • Möglichkeit 1: Die gesetzten Suchparameter sind nicht widersprüchlich, dennoch wurden mit den Suchparametern keine Ressourcen im 116117 Terminservice gefunden.

    • Ein Beispiel hierfür ist eine Suche nach Appointments mit einer ANR als Suchparameter: Existiert im 116117 Terminservice keine Terminbuchung, die dem Arzt mit der angegebenen ANR zugeordnet ist, enthält das Bundle mit den Suchergebnissen keinen Eintrag.

  • Möglichkeit 2: Die angegebenen Suchparameter schließen sich gegenseitig aus.

    • Wie auf den Seiten zu den jeweiligen search interactions beschrieben, prüfen die Systeme des 116117 Terminservices nur bedingt auf Plausibilität.

    • Ein Beispiel hierfür ist die Suche nach Appointments mit einer ANR und einer BSNR als Suchparameter: Die Systeme des 116117 Terminservices prüfen vorab NICHT, ob der Arzt mit der angegebenen ANR tatsächlich in der Praxis mit der angegebenen BSNR tätig ist. Ist der Arzt nicht in der Praxis tätig, wird kein Fehler sondern ein leeres Bundle zurückgegeben.

Lösung: Suchparameter prüfen und ggf. anpassen


Als Response auf einen Request kommt der HTTP-Statuscode 400 Bad Request zurück. Woran liegt das und was ist zu tun?

Ursache: Der gesendete Request ist nicht valide.

  • Beispiel: Unerlaubte Werte oder Zeichen in einem Suchparameter

Lösung: Request korrigieren

  • Das im Response Body enthaltene OperationOutcome enthält nähere Informationen zum aufgetrenen Fehler.

Als Response auf einen Request kommt der HTTP-Statuscode 401 Unauthorized zurück. Woran liegt das und was ist zu tun?

Ursache: Der Access Token, der im Header Authorization übergeben wurde, ist ungültig.

Lösung: Neuen Access Token anfragen


Als Response auf einen Request kommt der HTTP-Statuscode 403 Forbidden zurück. Woran liegt das und was ist zu tun?

Ursache: Die Authentifizierung für die Schnittstelle war erfolgreich, aber der Anfragende ist nicht für die gewünschte Aktion autorisiert. Das bedeutet, dass der Access Token, der im Header Authorization übergeben wurde, an sich gültig ist. Die BSNR der Praxis, für die Ressourcen abgerufen werden sollen, ist jedoch NICHT im Access Token enthalten.

Lösung: Access Token und Request überprüfen

  • Wurde der Access Token für die richtige BSNR angefordert?

  • Beim Abrufen von Ressourcen mit dem Suchparameter BSNR: Ist die BSNR korrekt, die im Request Body als Suchparameter angegeben wurde?


Als Response auf einen Request kommt der HTTP-Statuscode 405 Method Not Allowed zurück. Woran liegt das und was ist zu tun?

Ursache: Der angefragte Endpunkt existiert, aber die im Request verwendete HTTP-Methode ist für diesen Endpunkt nicht zulässig.

Lösung: HTTP-Methode korrigieren

  • Die erforderliche HTTP-Methode ist auf den Seiten zu den jeweiligen Interaktionen zu finden.

Als Response auf einen Request kommt der HTTP-Statuscode 412 Precondition Failed zurück. Woran liegt das und was ist zu tun?

Ursache: Ein verpflichtender Request Header fehlt oder enthält einen nicht erlaubten Wert.

Lösung: Request Header korrigieren

  • Die erforderlichen Request Header inkl. der erlaubten Werte und Beispiele sind auf den Seiten zu den jeweiligen Interaktionen zu finden.

Als Response auf einen Request kommt der HTTP-Statuscode 415 Unsupported Media Type zurück. Woran liegt das und was ist zu tun?

Ursache: Der Request Header Content-Type fehlt oder enthält einen nicht erlaubten Wert oder der Request Body hat das falsche Format.

Lösung: Request Header Content-Type oder Request Body korrigieren

  • Die erlaubten Werte für alle Request Header sowie Beispiele für den Request Body sind auf den Seiten zu den jeweiligen Interaktionen zu finden.

Als Response auf einen Request kommt der HTTP-Statuscode 500 Internal Server Error zurück. Woran liegt das und was ist zu tun?

Ursache: Es gibt ein technisches Problem beim 116117 Terminservice.

Lösung: Support-Ticket vom Typ Fehler im Serviceportal 116117 Terminservice der kv.digital GmbH erstellen