Motimate: Hoe upgrade ik van Public API v1 naar v2?

Onze nieuwe Openbare API v2 (PAPI v2) is nu gelanceerd en biedt een flexibelere en behulpzamere service ✨

Wat wordt er nieuw?

Met PAPI v2 krijgt u toegang tot een breder bereik van gegevens over meer eindpunten. Meer specifiek kun je nu meer gegevens exporteren en krijg je meer controle over je MotiSpace via de API.

Wat moet je doen?

Nog niets. Voorlopig hebben we de nieuwe versie gewoon gelanceerd en laten we geïnteresseerden ermee aan de slag gaan. Op dit moment worden niemand veranderingen opgedrongen. Lees verder voor meer informatie over de verwachte tijdlijn en wanneer we verwachten dat iedereen actie onderneemt om te upgraden (deze tijdlijn is nog steeds voorlopig).

Hoe kan ik v2 testen zonder volledig te upgraden?

Om gebruik te gaan maken van PAPI v2 terwijl het technisch nog steeds geïntegreerd is met v1, moet de HTTP-header motimate-public-api-version worden ingesteld op: v2.

Zodra je klaar bent om permanent over te stappen naar v2, laat je dit weten aan Support en zij zullen dit configureren in de back-end zodat deze header overbodig wordt.

Als je v2 hebt getest terwijl het in bèta was, hoef je geen wijzigingen aan te brengen, aangezien v2 niet is gewijzigd ten opzichte van de bètaversie.

Vereist upgraden naar v2 grote veranderingen in onze bestaande v1-implementatie?

De overgang naar PAPI v2 zou geen grote veranderingen met zich mee moeten brengen, omdat het voornamelijk kleinere aanpassingen zijn in het gebruik van onze eindpunten Users, Groups en Positions. Dat gezegd hebbende, zullen klanten die gebruik maken van externe ontwikkelaars op consultants natuurlijk wat tijd nodig hebben om hun integraties bij te werken en te testen.

Wat verandert er met betrekking tot de authenticatie?

Niets, zolang je PAPI v1 al gebruikt, zul je nog steeds dezelfde credentials gebruiken die je van het Motimate team hebt ontvangen toen je voor het eerst toegang tot de API aanvroeg om je 24h authenticatie tokens te verkrijgen.

Wordt v1 afgeschreven? Wat is de tijdlijn?

In eerste instantie hebben we gewoon PAPI v2 gelanceerd en gebruikers de mogelijkheid gegeven om te upgraden en het te gaan gebruiken. 

Ergens verderop in het proces zullen we een aankondiging doen om te laten weten dat we v1 gaan depreciteren, en vanaf dat moment zullen we een overgangsperiode van 6 maanden toestaan voor alle gebruikers om over te stappen naar v2. Houd er rekening mee dat dit een voorlopig plan is, dat kan worden gewijzigd.