Motimate: Bagaimana cara mengimpor Dokumentasi API Publik Motimate ke Postman?

Pendahuluan

Jika Anda seorang pengembang API, Anda pasti tahu betapa pentingnya menguji dan mendokumentasikan aplikasi Anda untuk memastikan fungsionalitas dan keandalannya. Postman adalah alat yang populer di kalangan pengembang karena menyediakan antarmuka yang mudah digunakan untuk membuat permintaan HTTP, menguji titik akhir, dan memvisualisasikan respons.

Salah satu fitur utama dari alat ini adalah kemampuan untuk mengimpor dokumentasi dalam format Open API. Pada artikel ini, kami akan memandu Anda melalui proses mengimpor dokumentasi API Publik Motimate (dalam format Open API 3.0) ke dalam Postman Collection, sehingga pengujian dan pengembangan API Anda menjadi lebih efisien.

Persyaratan

Sebelum kita mulai, Anda harus menginstal Postman pada sistem Anda. Anda dapat mengunduh Postman di sini.

Impor API Motimate untuk Koleksi Tukang Pos:

1. Buka halaman untuk mengunduh dokumentasi API Publik Motimate(di sini).
    
2. Temukan tombol Ekspor di sudut kanan atas, dan klik tombol tersebut. Pilih Unduh API, lalu JSON Tidak Terselesaikan.
    
3. Setelah file diunduh, buka Postman.
   
   
    
4. Buka tab Koleksi dan klik Impor. Unggah file yang diunduh sebagai Koleksi.
   
   
    
5. Saatnya mengatur otorisasi kita - klik Motimate Public API lalu pilih tab Variabel.
   
   
    

6. Tambahkan variabel baru bernama clientId dan atur nilai Initial ke nilai yang disediakan oleh Motimate. Nilai saat ini akan diperbarui secara otomatis.
   
   lalu...
   
    

   Tambahkan variabel baru bernama clientSecret dan atur nilai Initial ke nilai yang disediakan oleh Motimate. Nilai saat ini akan diperbarui secara otomatis.
   
   
   
    

7. Sangat penting: Klik Simpan!
   
   
   
    
8. Klik API Publik Motimate lagi dan pilih tab Otorisasi.
   
   
    

9. Atur Jenis ke OAuth 2.0. Sebuah formulir akan muncul. Gulir ke bawah ke bagian Konfigurasi Token Baru.

   Jika Anda melihat info "Beberapa perubahan pada Token…", cukup klik Edit Konfigurasi Token.
   
   
   
    

10. Tetapkan jenis Hibah ke Kredensial Klien:
    1. Atur URL Token Akses ke {{baseUrl}}/oauth/token
    2. Atur ID Klien ke {{clientId}}
    3. Atur Rahasia Klien ke {{clientSecret}}
       
       
       
        
11. Gulir ke bawah dan klik Dapatkan Token Akses Baru. Tukang pos akan memberi tahu Anda tentang otentikasi yang berhasil. Klik Lanjutkan dan kemudian Gunakan Token.
    
     
12. Sangat penting: Klik Simpan!
    
     

13. Klik: saya → ambil Organisasi Saat Ini → Kirim.

    Anda akan melihat respons dari API Publik Motimate, dengan data organisasi Anda.
    
    
    
     

    Selamat! Anda sekarang telah mengimpor API Publik Motimate ke Postman Collections 🎉