| Excerpt |
|---|
Der Auruf der REST-Schnittstellen erfolgt nach einem einheitlichen Prinzip. Dieser Ansatz vereinfacht die Implementierung. |
Inhaltsverzeichnis
| Table of Contents | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...
Parameter | Bedeutung |
|---|---|
SERVICEID | Stellt den OSB-Dienst dar. Dies ist nicht notwendigerweise die AppID des Dienstes. Beispiele: emm, hreflangCollector, images, pagespeedtool, websaleapp2, usw. |
ACTION | Wird dem OSB-Dienst als Parameter übergeben und der Dienst kann dann entsprechend reagieren. Wenn ein Dienst eine Aktion nicht kennt, sollte immer ein HTTP-Fehlercode 400 (Bad Request) zurückgegeben werden. Beispiele: changeemail, start, cancel, publish, build, send, usw. |
Authentifizierung
Es ist bei jedem OSB-Dienst wichtig, dass der User sich zuerst authentifiziert und dem Aufruf einen Token mitgibt. Wie ein Token beim Authentserver erzeugt wird, ist in der Dokumentation "REST Authentifizierung" beschrieben:
...
Für weitere Informationen zu JWT kann die offizielle Webseite besucht werden: https://jwt.io
| Info |
|---|
Der generierte Token ist nur für einen Zeitraum von 30 Minuten gültig. Sobald dieser nicht mehr gültig ist, geben alle Anfragen den Statuscode 401 zurück. Ist dies der Fall muss ein neuer Token generiert werden. |
REST-Anfrage an Dienst
Jeder Dienst mit einer REST-Schnittstelle muss über eine spezielle REST-kompatible URL aufrufbar sein.
...