Motimate：Public API v1からv2へのアップグレード方法を教えてください。

新しいPublic API v2(PAPI v2)がリリースされ、より柔軟で役立つサービスを提供します✨。

何が新しくなるのか？

PAPI v2では、より多くのエンドポイントにまたがる幅広いデータにアクセスできる。 具体的には、より多くのデータをエクスポートできるようになり、APIを介してMotiSpaceをよりコントロールできるようになります。

何をしなければならないのか？

まだ何もない。 当面は、新バージョンを立ち上げ、興味のある人たちに使い始めてもらうだけだ。 現時点では、いかなる変更も誰にも強制されることはない。 予想されるスケジュールと、アップグレードのための行動をいつ皆様に取っていただくかについての詳細は、さらに下をお読みください（このスケジュールはまだ暫定的なものです）。

完全にアップグレードせずにv2をテストするには？

技術的にはv1と統合されたまま、PAPI v2の利用を開始するには、HTTPヘッダー motimate-public-api-version に設定する必要があります： v2.

v2に移行する準備ができましたら、サポートにお知らせください。バックエンドでこのヘッダーが廃止されるように設定します。

ベータ版中にv2をテストしたことがある場合、v2はベータ版から変更されていないので、変更する必要はありません。

v2へのアップグレードには、既存のv1の実装に大きな変更が必要でしょうか？

PAPI v2への移行は、主にUsers、Groups、Positionsエンドポイントの使用に関する小規模な調整であるため、大きな変更は必要ありません。 とはいえ、サードパーティの開発者をコンサルタントに起用している顧客は、当然ながら統合の更新とテストに時間がかかる。

認証に関して何が変わったのか？

すでにPAPI v1を使用している場合は、24時間認証トークンを取得するために、最初にAPIへのアクセスを要求したときにMotimateチームから受け取ったのと同じ認証情報を使用できます。

v1は廃止されるのか？ タイムラインは？

最初の例では、我々は単純にPAPI v2を立ち上げ、ユーザーがアップグレードして使い始めることができるようにした。 

そして、その時点から6ヶ月の移行期間を設け、すべてのユーザーがv2に移行できるようにします。 これは暫定的なものであり、変更される可能性がある。