Motimate: Come faccio a passare dalla Public API v1 alla v2?

È stata lanciata la nostra nuova API pubblica v2 (PAPI v2), che offre un servizio più flessibile e utile ✨

Quali saranno le novità?

Con PAPI v2, puoi accedere a una gamma più ampia di dati su un maggior numero di endpoint. In particolare, ora potrai esportare un maggior numero di dati e ottenere un maggiore controllo sul tuo MotiSpace tramite l'API.

Cosa devi fare?

Ancora niente. Per il momento ci siamo limitati a lanciare la nuova versione e a permettere a chi è interessato di iniziare a usarla. In questo momento non verranno imposti cambiamenti a nessuno. Per saperne di più sulla tempistica prevista e su quando ci aspettiamo che tutti si attivino per l'aggiornamento, leggi più in basso (questa tempistica è ancora provvisoria).

Come posso testare la v2 senza aggiornare completamente?

Per iniziare a utilizzare il PAPI v2 pur essendo tecnicamente integrato con il v1, l'header HTTP motimate-public-api-version deve essere impostato su: v2.

Quando sarai pronto a passare definitivamente alla v2, fallo sapere all'assistenza che provvederà a configurare il back-end in modo che questa intestazione diventi obsoleta.

Se hai testato la v2 quando era in versione beta, non devi apportare alcuna modifica, poiché la v2 non è cambiata rispetto alla versione beta.

L'aggiornamento alla v2 richiederà grandi modifiche alla nostra attuale implementazione della v1?

La transizione al PAPI v2 non dovrebbe richiedere grandi cambiamenti, in quanto si tratta principalmente di piccoli aggiustamenti nell'uso dei nostri endpoint Utenti, Gruppi e Posizioni. Detto questo, i clienti che utilizzano sviluppatori di terze parti come consulenti, avranno naturalmente bisogno di un po' di tempo per aggiornare e testare le loro integrazioni.

Cosa sta cambiando per quanto riguarda l'autenticazione?

Niente, se stai già utilizzando PAPI v1, continuerai a usare le stesse credenziali che hai ricevuto dal team Motimate quando hai richiesto l'accesso all'API per ottenere i tuoi token di autenticazione 24h.

La v1 sarà deprecata? Qual è la tempistica?

In un primo momento, abbiamo semplicemente lanciato il PAPI v2 e permesso agli utenti di aggiornarlo e iniziare a usarlo. 

A un certo punto faremo un annuncio per informare che la v1 verrà deprezzata e che da quel momento concederemo a tutti gli utenti un periodo di transizione di 6 mesi per passare alla v2. Si noti che si tratta di un piano provvisorio, soggetto a modifiche.