Motimate: Hvordan opgraderer jeg fra Public API v1 til v2?

Vores nye offentlige API v2 (PAPI v2) er nu lanceret og giver en mere fleksibel og hjælpsom service ✨

Hvad vil være nyt?

Med PAPI v2 får du adgang til en bredere vifte af data på tværs af flere endpoints. Helt konkret vil du nu kunne eksportere flere data og få mere kontrol over dit MotiSpace via API'en.

Hvad skal du gøre?

Ikke noget endnu. Indtil videre har vi blot lanceret den nye version og lader dem, der er interesserede, begynde at bruge den. Ingen ændringer vil blive påtvunget nogen på nuværende tidspunkt. Læs længere nede for at finde ud af mere om den forventede tidslinje, og hvornår vi forventer, at alle tager skridt til at opgradere (denne tidslinje er stadig kun foreløbig).

Hvordan kan jeg teste v2 uden at opgradere helt?

For at begynde at bruge PAPI v2, mens man stadig teknisk set er integreret med v1, skal HTTP-headeren motimate-public-api-version skal sættes til: v2.

Når du er klar til at gå permanent over til v2, skal du give support besked, og de vil konfigurere dette i back-end, så denne header bliver forældet.

Hvis du har testet v2, mens den var i beta, behøver du ikke foretage nogen ændringer, da v2 ikke er ændret i forhold til betaversionen.

Vil en opgradering til v2 kræve store ændringer i vores eksisterende v1-implementering?

Overgangen til PAPI v2 burde ikke kræve store ændringer, da det primært er mindre justeringer i brugen af vores Users, Groups og Positions endpoints. Når det er sagt, vil kunder, der bruger tredjepartsudviklere på konsulenter, naturligvis have brug for lidt tid til at opdatere og teste deres integrationer.

Hvad ændrer sig med hensyn til autentificeringen?

Intet, så længe du allerede bruger PAPI v1, vil du stadig bruge de samme legitimationsoplysninger, som du modtog fra Motimate-teamet, da du første gang anmodede om adgang til API'en for at få dine 24 timers godkendelsestokens.

Vil v1 blive udfaset? Hvad er tidslinjen?

I første omgang har vi simpelthen lanceret PAPI v2 og givet brugerne mulighed for at opgradere og begynde at bruge den. 

På et tidspunkt vil vi offentliggøre en meddelelse om, at vi vil afskaffe v1, og fra det tidspunkt vil vi give alle brugere en overgangsperiode på 6 måneder til at skifte til v2. Bemærk, at dette er en foreløbig plan, som kan ændres.