Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen gezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen Revision Vorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
webservice:vermittler [2018/08/29 09:18]
admin [Vermittler-Untervermittler-anlegen]
webservice:vermittler [2019/10/29 16:16] (aktuell)
admin [Fehlerbehandlung]
Zeile 44: Zeile 44:
  
 ===== Fehlerbehandlung ===== ===== Fehlerbehandlung =====
-Über den Erfolg eines Aufrufes gibt der HTTP-Status-Code im Header der Antwort ​aufschluss. Ist eine Aktion erfolgreich wird i.d.R der code **200** (OK) zurückgegeben. Falls ein Fehler aufgetreten ist und die Ursache beim Client liegt, wird mit einem der **4xx** codes geantwortet,​ liegt die Ursache beim Server mit **500** ​ (Internal Server Error). +Über den Erfolg eines Aufrufes gibt der HTTP-Status-Code im Header der Antwort ​Aufschluss. Ist eine Aktion erfolgreich wird i.d.R der code **200** (OK) zurückgegeben. Falls ein Fehler aufgetreten ist und die Ursache beim Client liegt, wird mit einem der **4xx** codes geantwortet,​ liegt die Ursache beim Server mit **500** ​ (Internal Server Error). 
-Liegt der Fehler beim Anwender wird zusätzlich im HTTP-Body ein JSON-Objekt mit den anzuzeigenden Meldungen ausgegeben, falls nicht wird eine standard ​HTML-Fehlerseite ausgegeben.+Liegt der Fehler beim Anwender wird zusätzlich im HTTP-Body ein JSON-Objekt mit den anzuzeigenden Meldungen ausgegeben, falls nicht wird eine Standard ​HTML-Fehlerseite ausgegeben.
 === Beispiel === === Beispiel ===
 <​code>​ <​code>​
Zeile 59: Zeile 59:
 } }
 </​code>​ </​code>​
 +=== Error-Codes bei der Authentifizierung === 
 +| 400 | Auth-Header unplausibel oder unplausibles Digest | 
 +| 403 | Vermittler ist gesperrt | 
 +| 404 | Api-ID existiert nicht | 
 +| 500 | technischer Fehler oder Infrastruktur-Problem |
 ===== Datentypen ===== ===== Datentypen =====
 ==== SimpleTypes ==== ==== SimpleTypes ====