Motimate: Hur uppgraderar jag från Public API v1 till v2?

Vårt nya Public API v2 (PAPI v2) har nu lanserats, vilket ger en mer flexibel och hjälpsam tjänst ✨

Vad kommer att vara nytt?

Med PAPI v2 får du tillgång till en större mängd data på fler slutpunkter. Mer specifikt kommer du nu att kunna exportera mer data och få mer kontroll över ditt MotiSpace via API:et.

Vad måste du göra?

Inget än. För närvarande har vi helt enkelt lanserat den nya versionen och låter de som är intresserade börja använda den. Inga förändringar kommer att tvingas på någon vid denna tidpunkt. Läs längre ner för att få reda på mer om den förväntade tidsplanen och när vi förväntar oss att alla vidtar åtgärder för att uppgradera (denna tidsplan är fortfarande endast preliminär).

Hur kan jag testa v2 utan att uppgradera helt?

För att börja använda PAPI v2 medan man fortfarande tekniskt sett är integrerad med v1, ska HTTP-rubriken motimate-public-api-version måste ställas in till: v2.

När du är redo att permanent gå över till v2, meddela support så konfigurerar de detta i backend så att denna rubrik blir föråldrad.

Om du har testat v2 när den var i beta behöver du inte göra några ändringar, eftersom v2 inte har ändrats från betaversionen.

Kommer uppgradering till v2 att kräva stora förändringar av vår befintliga v1-implementering?

Övergången till PAPI v2 bör inte kräva några större förändringar eftersom det främst handlar om mindre justeringar av användningen av våra slutpunkter Users, Groups och Positions. Med detta sagt kommer kunder som använder tredjepartsutvecklare på konsultbasis naturligtvis att behöva lite tid för att uppdatera och testa sina integrationer.

Vad är det som förändras när det gäller autentiseringen?

Ingenting, så länge du redan använder PAPI v1 kommer du fortfarande att använda samma autentiseringsuppgifter som du fick från Motimate-teamet när du först begärde åtkomst till API:et för att få dina 24-timmars autentiseringstoken.

Kommer v1 att bli föråldrad? Hur ser tidslinjen ut?

I det första fallet har vi helt enkelt lanserat PAPI v2 och låtit användarna uppgradera och börja använda det. 

Någon gång längre fram kommer vi att göra ett tillkännagivande för att informera om att vi kommer att avveckla v1, och från den tiden kommer vi att tillåta en övergångsperiod på 6 månader för alla användare att gå över till v2. Observera att detta är en preliminär plan som kan komma att ändras.