URL: https://timewerk.de
Für die Authorisierung unserer OAuth2-Schnittstelle verwenden wir den Grant Type "Client credentials". Diese bekommen Sie 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 inhaltich bzgl. der Rückgabewerte zu 100% kompatibel mit unserer bestehenden Schnittstelle. Daher können Sie sich bzgl. der genauen Details zu den Feldbezeichnungen unsere bestehende Dokumentation analog anschauen. Diese finden sie unter: Beispiel (PHP) bzw. Erfassungsfelder
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 aller Gesellschaften zurück (csv).
Fehler (404): Zugriff nicht erlaubt