Motimate: Como faço para atualizar da API pública v1 para a v2?

Nossa nova API pública v2 (PAPI v2) já foi lançada, oferecendo um serviço mais flexível e útil ✨ Você pode usar a API pública v2 para obter mais informações.

O que você terá de novo?

Com a PAPI v2, você tem acesso a um escopo mais amplo de dados em mais pontos de extremidade. Especificamente, agora você poderá exportar mais dados, além de obter mais controle sobre o seu MotiSpace por meio da API.

O que você deve fazer?

Nada ainda. Por enquanto, simplesmente lançamos a nova versão e permitimos que os interessados comecem a usá-la. Nenhuma mudança será imposta a ninguém neste momento. Leia mais abaixo para saber mais sobre o cronograma esperado e quando esperamos que todos tomem medidas para fazer a atualização (esse cronograma ainda é apenas provisório).

Como posso testar a v2 sem fazer a atualização completa?

Para que você comece a usar o PAPI v2 e, ao mesmo tempo, ainda esteja tecnicamente integrado ao v1, o cabeçalho HTTP motimate-public-api-version deve ser definido como: v2.

Quando você estiver pronto para mudar permanentemente para a v2, informe o suporte e ele configurará isso no back-end para que esse cabeçalho se torne obsoleto.

Se você testou a v2 enquanto ela estava na versão beta, não precisará fazer nenhuma alteração, pois a v2 não foi alterada em relação à versão beta.

A atualização para a v2 exigirá grandes mudanças em nossa implementação existente da v1?

A transição para a PAPI v2 não deve exigir grandes mudanças, pois se trata principalmente de ajustes menores no uso de nossos pontos de extremidade de Usuários, Grupos e Posições. Dito isso, os clientes que usam desenvolvedores de terceiros em consultores naturalmente precisarão de algum tempo para atualizar e testar suas integrações.

O que está mudando com relação à autenticação?

Nada, desde que você já esteja usando a PAPI v1, você ainda usará as mesmas credenciais que recebeu da equipe da Motimate quando solicitou acesso à API pela primeira vez para obter seus tokens de autenticação 24h.

A v1 será descontinuada? Qual é a linha do tempo?

No primeiro caso, simplesmente lançamos o PAPI v2 e permitimos que os usuários façam a atualização e comecem a usá-lo. 

Em algum momento, faremos um anúncio informando que a versão 1 será descontinuada e, a partir desse momento, permitiremos um período de transição de 6 meses para que todos os usuários migrem para a versão 2. Observe que este é um plano provisório, que está sujeito a alterações.