URL: https://www.psponline.de
Für die Authorisierung unserer OAuth2-Schnittstelle verwenden wir den Grant Type "Client credentials". Diese bekommst du von uns mitgeteilt und sehen beispielhaft wie folgt aus:
Client ID: 30000#m.mustermann (Lizenznummer#Benutzername)
Client Secret: Eine zufällige, von uns vergebene Zeichenkette
Die Angabe eines Scopes ist nicht erforderlich.
Die Endpunkte mit dem v1 Präfix in der URI sind inhaltlich bzgl. der Rückgabewerte zu 100% kompatibel mit der vorhergehenden Schnittstelle.
Erfolg (302): Erzeugt Weiterleitung inkl. einer Session in der Oberfläche von psponline. Wenn optional eine Angebot ID (offerId) mit angegeben wird, startet man in der Oberfläche direkt mit dem Angebot. Ebenso können optional per POST beliebige Erfassungsfelder mit übergeben werden.
Fehler (401): Kein gültiger Nutzer
Erfolg (200): Gibt immer das zuletzt erstellte Angebot zurück (JSON+PDF's).
Fehler (404): Es wurde bis jetzt kein Angebot erstellt
Erfolg (200): Gibt ein spezifisches Angebot unter Angabe der Angebot ID (offerId) zurück (JSON+PDF's). Die Angebot ID muss zuvor über den Endpunkt /api/v1/offer/latest geholt worden sein.
Fehler (404): Das angeforderte Angebot wurde nicht gefunden
Erfolg (200): Gibt Liste der verkaufsoffenen Tarife oder Tarifkombinationen zurück (JSON).
Fehler (404): Zugriff nicht erlaubt
Erfolg (200): Gibt Liste der Gesellschaften zurück (JSON).
Fehler (404): Zugriff nicht erlaubt
Erfolg (200): Gibt Liste der Tarifarten zurück (JSON).
Fehler (404): Zugriff nicht erlaubt