Motimate: Wie upgrade ich von Public API v1 auf v2?

Unsere neue öffentliche API v2 (PAPI v2) ist jetzt eingeführt und bietet einen flexibleren und hilfreicheren Service ✨.

Was wird neu sein?

Mit PAPI v2 erhältst du Zugang zu einer größeren Anzahl von Daten über mehr Endpunkte. Insbesondere kannst du jetzt mehr Daten exportieren und hast über die API mehr Kontrolle über deinen MotiSpace.

Was musst du tun?

Noch nicht. Vorerst haben wir die neue Version einfach auf den Markt gebracht und erlauben allen, die daran interessiert sind, sie zu nutzen. Zu diesem Zeitpunkt werden niemandem Änderungen aufgezwungen. Lies bitte weiter unten, um mehr über den voraussichtlichen Zeitplan zu erfahren und wann wir erwarten, dass jeder das Upgrade durchführt (dieser Zeitplan ist immer noch nur vorläufig).

Wie kann ich v2 testen, ohne vollständig zu aktualisieren?

Um PAPI v2 zu nutzen, während es technisch noch in v1 integriert ist, wird der HTTP-Header motimate-public-api-version auf gesetzt werden: v2.

Wenn du bereit bist, dauerhaft auf v2 umzusteigen, sag dem Support Bescheid und er wird dies im Backend so konfigurieren, dass diese Kopfzeile überflüssig wird.

Wenn du v2 getestet hast, als sie noch in der Beta-Phase war, musst du keine Änderungen vornehmen, denn v2 hat sich gegenüber der Beta-Version nicht verändert.

Erfordert das Upgrade auf v2 große Änderungen an unserer bestehenden v1-Implementierung?

Die Umstellung auf PAPI v2 sollte keine größeren Änderungen erfordern, da es sich hauptsächlich um kleinere Anpassungen bei der Verwendung unserer Endpunkte Benutzer, Gruppen und Positionen handelt. Allerdings benötigen Kunden, die 3rd-Party-Entwickler als Berater einsetzen, natürlich etwas Zeit, um ihre Integrationen zu aktualisieren und zu testen.

Was ändert sich in Bezug auf die Authentifizierung?

Nichts, solange du bereits PAPI v1 verwendest, verwendest du weiterhin dieselben Anmeldedaten, die du vom Motimate-Team erhalten hast, als du zum ersten Mal Zugang zur API beantragt hast, um deine 24-Stunden-Authentifizierungstoken zu erhalten.

Wird v1 veraltet sein? Wie sieht der Zeitplan aus?

Zunächst haben wir einfach PAPI v2 eingeführt und den Nutzern erlaubt, es zu aktualisieren und zu verwenden. 

Irgendwann in der Zukunft werden wir eine Ankündigung machen, dass wir v1 abschaffen und allen Nutzern eine 6-monatige Übergangszeit einräumen, um auf v2 zu wechseln. Beachte, dass dies ein vorläufiger Plan ist, der sich noch ändern kann.