Motimate：如何從 Public API v1 升級到 v2？

我們全新的公共 API v2(PAPI v2) 現已推出，提供更靈活、更有用的服務 ✨

會有什麼新變化？

有了 PAPI v2，您可以存取更多端點的更廣泛資料。具體而言，您現在可以匯出更多資料，並透過 API 對 MotiSpace 進行更多控制。

您必須做什麼？

還沒有目前，我們只是推出新版本，讓有興趣的人開始使用。目前不會強迫任何人做任何變更。請繼續往下閱讀，以瞭解更多關於預期時間表的資訊，以及我們期望大家採取行動升級的時間 (此時間表僅為暫定)。

如何在未完全升級的情況下測試 v2？

為了開始使用 PAPI v2，同時在技術上仍與 v1 整合，HTTP 標頭 motimate-public-api-version 必須設定為 v2.

一旦您準備好永久移轉到 v2，請通知支援人員，他們會在後端設定，使此標頭過時。

如果您已在beta 版測試 v2，則無需進行任何變更，因為 v2 與beta 版相比並無變更。

升級到 v2 是否需要對我們現有的 v1 實作進行重大變更？

過渡到 PAPI v2 應該不需要重大變更，因為主要是在使用我們的「使用者」、「群組」和「職位」端點上進行較小的調整。話雖如此，使用第三方開發人員顧問的客戶自然需要一些時間來更新和測試他們的整合。

認證方面有什麼變化？

什麼都沒有，只要您已經在使用 PAPI v1，您仍然可以使用您第一次要求存取 API 時從 Motimate 團隊收到的相同憑證，以取得您的 24 小時驗證權限。

v1 會被廢棄嗎？時間表是什麼？

首先，我們簡單地推出 PAPI v2，並允許使用者升級和開始使用。 

在未來的某個時候，我們會發佈公告，通知大家我們將會淘汰 v1 版本，屆時我們會給所有使用者 6 個月的過渡期，讓他們轉換到 v2 版本。請注意，此為臨時計劃，可能會有所變更。