Motimate: ¿Cómo actualizo de la API Pública v1 a la v2?

Ya está en marcha nuestra nueva API pública v2 (PAPI v2), que ofrece un servicio más flexible y útil ✨

¿Qué habrá de nuevo?

Con el PAPI v2, tendrás acceso a una mayor cantidad de datos en más puntos finales. En concreto, ahora podrás exportar más datos, además de tener más control sobre tu MotiSpace a través de la API.

¿Qué debes hacer?

Todavía nada. De momento, nos hemos limitado a lanzar la nueva versión y a permitir que quienes estén interesados empiecen a utilizarla. No se impondrán cambios a nadie en este momento. Lee más abajo para saber más sobre el calendario previsto y cuándo esperamos que todo el mundo tome medidas para actualizarse (este calendario es provisional).

¿Cómo puedo probar la v2 sin actualizarla completamente?

Para empezar a utilizar PAPI v2 sin dejar de estar técnicamente integrado con v1, la cabecera HTTP motimate-public-api-version debe establecerse como v2.

Cuando estés listo para pasar definitivamente a la v2, comunícalo al servicio de asistencia y ellos lo configurarán en el back-end para que este encabezado quede obsoleto.

Si has probado la v2 mientras estaba en beta, no necesitas hacer ningún cambio, ya que la v2 no ha cambiado respecto a la versión beta.

¿La actualización a la v2 requerirá grandes cambios en nuestra actual implementación de la v1?

La transición al PAPI v2 no debería requerir grandes cambios, ya que se trata principalmente de pequeños ajustes en el uso de nuestros puntos finales Usuarios, Grupos y Cargos. Dicho esto, los clientes que utilicen desarrolladores de terceros en las consultoras, necesitarán naturalmente algo de tiempo para actualizar y probar sus integraciones.

¿Qué cambia con respecto a la autentificación?

Nada, mientras ya estés utilizando PAPI v1, seguirás utilizando las mismas credenciales que recibiste del equipo de Motimate la primera vez que solicitaste acceso a la API para obtener tus tokens de autenticación 24h.

¿Quedará obsoleta la v1? ¿Cuál es el calendario?

En el primer caso, nos hemos limitado a lanzar el PAPI v2 y a permitir que los usuarios lo actualicen y empiecen a utilizarlo. 

En algún momento más adelante, haremos un anuncio para informar de que dejaremos de utilizar la v1, y a partir de ese momento concederemos un periodo de transición de 6 meses para que todos los usuarios pasen a la v2. Ten en cuenta que se trata de un plan provisional, sujeto a cambios.