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

Vårt nye Public API v2 (PAPI v2) er nå lansert, og tilbyr en mer fleksibel og nyttig tjeneste ✨

Hva vil være nytt?

Med PAPI v2 får du tilgang til et bredere spekter av data på flere endepunkter. Du vil nå kunne eksportere mer data og få mer kontroll over MotiSpace via API-et.

Hva må du gjøre?

Ingenting ennå. Foreløpig har vi bare lansert den nye versjonen, og de som er interessert, kan begynne å bruke den. Ingen endringer vil bli påtvunget noen på dette tidspunktet. Les lenger ned for å finne ut mer om den forventede tidslinjen, og når vi forventer at alle gjør noe for å oppgradere (denne tidslinjen er fortsatt bare foreløpig).

Hvordan kan jeg teste v2 uten å oppgradere helt?

For å kunne begynne å bruke PAPI v2 samtidig som man teknisk sett fortsatt er integrert med v1, må HTTP-overskriften motimate-public-api-version må settes til: v2.

Når du er klar til å gå permanent over til v2, kan du gi beskjed til kundestøtte, så vil de konfigurere dette i back-end slik at denne overskriften blir foreldet.

Hvis du har testet v2 mens den var i betaversjon, trenger du ikke gjøre noen endringer, siden v2 ikke er endret fra betaversjonen.

Vil en oppgradering til v2 kreve store endringer i vår eksisterende v1-implementering?

Overgangen til PAPI v2 bør ikke kreve store endringer, ettersom det først og fremst dreier seg om mindre justeringer i bruken av endepunktene Users, Groups og Positions. Når det er sagt, vil kunder som bruker tredjepartsutviklere på konsulenter, naturlig nok trenge litt tid til å oppdatere og teste integrasjonene sine.

Hva er det som endrer seg når det gjelder autentiseringen?

Ingenting, så lenge du allerede bruker PAPI v1, vil du fortsatt bruke de samme legitimasjonsopplysningene du mottok fra Motimate-teamet da du først ba om tilgang til API-et for å få dine 24 timers autentiseringstokener.

Vil v1 bli utfaset? Hva er tidslinjen?

I første omgang har vi ganske enkelt lansert PAPI v2, slik at brukerne kan oppgradere og ta den i bruk. 

En gang i fremtiden vil vi komme med en kunngjøring om at vi kommer til å gå bort fra v1, og fra det tidspunktet vil vi gi alle brukere en overgangsperiode på 6 måneder til å gå over til v2. Merk at dette er en foreløpig plan, som kan bli endret.