Motimate: Jak dokonać aktualizacji z Public API v1 do v2?

Nasze nowe publiczne API v2 (PAPI v2) zostało uruchomione, zapewniając bardziej elastyczną i pomocną usługę ✨

Co będzie nowego?

Dzięki PAPI v2 uzyskasz dostęp do szerszego zakresu danych z większej liczby punktów końcowych. W szczególności będziesz mógł teraz wyeksportować więcej danych, a także uzyskać większą kontrolę nad MotiSpace za pośrednictwem interfejsu API.

Co musisz zrobić?

Jeszcze nic. Na razie po prostu uruchomiliśmy nową wersję i pozwalamy zainteresowanym zacząć z niej korzystać. W tej chwili żadne zmiany nie będą na nikim wymuszane. Przeczytaj dalej, aby dowiedzieć się więcej o oczekiwanym harmonogramie i kiedy będziemy oczekiwać, że wszyscy podejmą działania w celu aktualizacji (ten harmonogram jest nadal tylko tymczasowy).

Jak mogę przetestować v2 bez pełnej aktualizacji?

W celu rozpoczęcia korzystania z PAPI v2, przy jednoczesnym zachowaniu technicznej integracji z v1, nagłówek HTTP motimate-public-api-version musi być ustawiony na: v2.

Gdy będziesz gotowy, aby na stałe przejść na wersję 2, poinformuj o tym dział pomocy technicznej, a on skonfiguruje to w zapleczu, tak aby ten nagłówek stał się nieaktualny.

Jeśli testowałeś wersję v2 w wersji beta, nie musisz wprowadzać żadnych zmian, ponieważ wersja v2 nie zmieniła się w stosunku do wersji beta.

Czy aktualizacja do wersji v2 będzie wymagała dużych zmian w naszej istniejącej implementacji v1?

Przejście na PAPI v2 nie powinno wymagać większych zmian, ponieważ jest to przede wszystkim mniejsze dostosowanie w zakresie korzystania z naszych punktów końcowych Users, Groups i Positions. To powiedziawszy, klienci korzystający z usług zewnętrznych programistów na konsultantach będą oczywiście potrzebować trochę czasu na aktualizację i przetestowanie swoich integracji.

Co się zmieniło w kwestii uwierzytelniania?

Nic, o ile korzystasz już z PAPI v1, nadal będziesz używać tych samych danych uwierzytelniających, które otrzymałeś od zespołu Motimate, gdy po raz pierwszy poprosiłeś o dostęp do API w celu uzyskania tokenów uwierzytelniających 24h.

Czy v1 będzie przestarzałe? Jaka jest oś czasu?

W pierwszym przypadku po prostu uruchomiliśmy PAPI v2 i pozwoliliśmy użytkownikom na aktualizację i rozpoczęcie korzystania z niego. 

Jakiś czas później ogłosimy, że wycofamy wersję v1, a od tego czasu zapewnimy wszystkim użytkownikom 6-miesięczny okres przejściowy na przejście do wersji v2. Pamiętaj, że jest to plan tymczasowy, który może ulec zmianie.