Motimate: Bagaimana cara meningkatkan dari API Publik v1 ke v2?

API Publik v2 (PAPI v2) kami yang baru kini telah diluncurkan, menyediakan layanan yang lebih fleksibel dan bermanfaat ✨

Apa saja yang baru?

Dengan PAPI v2, Anda mendapatkan akses ke cakupan data yang lebih luas di lebih banyak titik akhir. Secara khusus, Anda sekarang dapat mengekspor lebih banyak data, serta mendapatkan lebih banyak kontrol atas MotiSpace Anda melalui API.

Apa yang harus Anda lakukan?

Belum ada. Untuk saat ini, kami baru saja meluncurkan versi baru dan mengizinkan mereka yang tertarik untuk mulai menggunakannya. Tidak ada perubahan yang akan dipaksakan pada siapa pun saat ini. Silakan baca lebih lanjut untuk mengetahui lebih lanjut tentang jadwal yang diharapkan, dan kapan kami akan mengharapkan semua orang mengambil tindakan untuk meningkatkan (jadwal ini masih bersifat sementara).

Bagaimana cara menguji v2 tanpa melakukan upgrade sepenuhnya?

Untuk mulai menggunakan PAPI v2 sementara secara teknis masih terintegrasi dengan v1, header HTTP motimate-public-api-version harus diatur ke: v2.

Setelah Anda siap untuk berpindah secara permanen ke v2, beri tahu Tim Dukungan dan mereka akan mengonfigurasikannya di back-end sehingga header ini menjadi tidak berlaku lagi.

Jika Anda telah menguji v2 ketika masih dalam versi beta, Anda tidak perlu melakukan perubahan apa pun, karena v2 tidak berubah dari versi beta.

Apakah peningkatan ke v2 akan memerlukan perubahan besar pada implementasi v1 yang sudah ada?

Transisi ke PAPI v2 seharusnya tidak memerlukan perubahan besar karena ini terutama penyesuaian kecil pada penggunaan endpoint Pengguna, Grup, dan Posisi. Oleh karena itu, pelanggan yang menggunakan pengembang pihak ketiga sebagai konsultan, secara alami akan membutuhkan waktu untuk memperbarui dan menguji integrasi mereka.

Apa yang berubah sehubungan dengan autentikasi?

Tidak ada, selama Anda sudah menggunakan PAPI v1, Anda akan tetap menggunakan kredensial yang sama dengan yang Anda terima dari tim Motimate saat pertama kali meminta akses ke API untuk mendapatkan token otentikasi 24 jam.

Apakah v1 akan ditinggalkan? Apa yang dimaksud dengan garis waktu?

Pada contoh pertama, kami hanya meluncurkan PAPI v2 dan mengizinkan pengguna untuk meng-upgrade dan mulai menggunakannya. 

Dalam beberapa waktu ke depan, kami akan membuat pengumuman untuk menginformasikan bahwa kami akan menghentikan penggunaan v1, dan sejak saat itu kami akan memberikan waktu transisi selama 6 bulan bagi semua pengguna untuk beralih ke v2. Harap diperhatikan bahwa ini adalah rencana sementara, yang dapat berubah sewaktu-waktu.