Motimate: Як оновити Public API v1 до v2?

Запущено наш новий публічний API v2 (PAPI v2), який забезпечує більш гнучкий та корисний сервіс ✨.

Що буде нового?

З PAPI v2 ви отримуєте доступ до ширшого обсягу даних на більшій кількості кінцевих точок. Зокрема, тепер ви зможете експортувати більше даних, а також отримати більше контролю над вашим MotiSpace через API.

Що ви повинні зробити?

Поки що нічого. Наразі ми просто запустили нову версію і дозволили тим, хто зацікавлений, почати користуватися нею. Наразі нікого не змушуватимуть до жодних змін. Будь ласка, прочитайте далі, щоб дізнатися більше про очікуваний графік і про те, коли ми будемо очікувати від усіх бажаючих вжити заходів для оновлення (цей графік поки що є лише попереднім).

Як я можу протестувати версію 2 без повного оновлення?

Для того, щоб почати використовувати PAPI v2, все ще технічно інтегрований з v1, HTTP-заголовок motimate-public-api-version повинен мати значення v2.

Коли ви будете готові остаточно перейти на версію 2, повідомте про це службу підтримки, і вони налаштують бекенд так, щоб цей заголовок став застарілим.

Якщо ви тестували версію 2, коли вона була в бета-версії, вам не потрібно вносити жодних змін, оскільки версія 2 не змінилася порівняно з бета-версією.

Чи потребуватиме оновлення до версії 2 значних змін у нашій існуючій реалізації версії 1?

Перехід на PAPI v2 не повинен вимагати значних змін, оскільки це, в основному, невеликі коригування у використанні наших кінцевих точок користувачів, груп і посад. З огляду на це, клієнтам, які залучають сторонніх розробників як консультантів, природно, знадобиться деякий час для оновлення та тестування своїх інтеграцій.

Що змінюється щодо автентифікації?

Нічого, оскільки ви вже використовуєте PAPI v1, ви все одно будете використовувати ті ж облікові дані, які ви отримали від команди Motimate, коли вперше запитували доступ до API, щоб отримати свої 24-годинні токени автентифікації.

Чи буде застаріла версія 1? Які часові рамки?

В першу чергу, ми просто запустили PAPI v2 і дозволили користувачам оновити його і почати використовувати. 

Дещо пізніше ми зробимо оголошення про те, що ми припиняємо випуск версії 1, і з цього часу ми надамо 6-місячний перехідний період для всіх користувачів для переходу на версію 2. Зверніть увагу, що це попередній план, який може бути змінений.