Vår nye Public API v2 (PAPI v2) er nå lansert, og gir en mer fleksibel og hjelpsom tjeneste ✨
Du kan finne dokumentasjonen for PAPI v2 her.
Hva er nytt?
Med PAPI v2 får du tilgang til et bredere spekter av data på flere endepunkter. Spesielt vil du nå kunne eksportere mer data, samt få mer kontroll over ditt MotiSpace via API-et.
Hva må du gjøre?
Foreløpig ingenting. Vi har kun lansert den nye versjonen og lar de som er interesserte begynne å bruke den. Ingen endringer vil bli påtvunget på nåværende tidspunkt. Les videre for å finne ut mer om den forventede tidslinjen, og når vi vil be alle om å oppgradere (denne tidslinjen er foreløpig og kan endres).
Hvordan kan jeg teste v2 uten å oppgradere fullt ut?
For å teste PAPI v2 for enkelt-spørringer mens du fortsatt teknisk sett er integrert med v1, inkluderer du enkelt HTTP-headeren motimate-public-api-version som settes til: v2.
Når du er klar til å flytte permanent til v2, gi beskjed til Support, så vil de konfigurere dette i back-end, slik at denne headeren blir overflødig.
Hvis du testet v2 mens den var i beta, trenger du ikke å gjøre noen endringer, siden v2 ikke har endret seg siden beta-versjonen.
Vil oppgradering til v2 kreve store endringer i vår eksisterende v1-implementering?
Overgangen til PAPI v2 burde ikke kreve store endringer, da det hovedsakelig er mindre justeringer i bruken av våre Users, Groups og Positions-endepunkter. Når det er sagt, vil kunder som bruker tredjepartsutviklere eller konsulenter, naturligvis trenge tid til å oppdatere og teste sine integrasjoner.
Hva endrer seg med hensyn til autentisering?
Ingenting. Så lenge du allerede bruker PAPI v1, vil du fortsatt bruke de samme legitimasjonene du fikk fra Motimate-teamet da du først ba om tilgang til API-et for å få dine 24-timers autentiseringstokener.
Vil v1 bli avviklet? Hva er tidslinjen?
I første omgang har vi kun lansert PAPI v2 og lar brukere oppgradere og begynne å bruke det.
På et senere tidspunkt vil vi kunngjøre at vi vil avvikle v1, og fra det tidspunktet vil vi gi en 6-måneders overgangsperiode for alle brukere til å flytte til v2. Merk at dette er en foreløpig plan, som kan endres.