Dasar integrasi Partner API

Integrasi andal dimulai dari kontrak API publik, satu kredensial terkendali, dan alur permintaan kecil yang diverifikasi. Gunakan field dan status MangoOTP, bukan asumsi layanan lain.

Buat API key aktif

Setiap pengguna memiliki maksimal satu key aktif. Nilai mentah hanya muncul saat dibuat, jadi simpan di sistem rahasia terlindungi.

Untuk “Dasar integrasi Partner API”, perlakukan “Buat API key aktif” sebagai satu titik pemeriksaan, bukan alasan untuk mengubah banyak hal sekaligus. Catat hasil, waktu, dan nomor terkait, lalu lakukan hanya satu langkah yang beralasan.

Atur daftar IP wajib

Setiap key memerlukan daftar IPv4 atau CIDR yang tidak kosong. Permintaan harus berasal dari alamat yang diizinkan platform.

Untuk “Dasar integrasi Partner API”, perlakukan “Atur daftar IP wajib” sebagai satu titik pemeriksaan, bukan alasan untuk mengubah banyak hal sekaligus. Catat hasil, waktu, dan nomor terkait, lalu lakukan hanya satu langkah yang beralasan.

Gunakan X-API-Key

Endpoint Partner menerima X-API-Key, bukan USER JWT. Kirim lewat HTTPS dan jangan taruh key di query, browser, repositori, atau log.

Untuk “Dasar integrasi Partner API”, perlakukan “Gunakan X-API-Key” sebagai satu titik pemeriksaan, bukan alasan untuk mengubah banyak hal sekaligus. Catat hasil, waktu, dan nomor terkait, lalu lakukan hanya satu langkah yang beralasan.

Cari katalog sebelum memesan

Gunakan panggilan katalog dan harga activation atau rental. Harga dan stok adalah perkiraan saat ini, bukan reservasi.

Untuk “Dasar integrasi Partner API”, perlakukan “Cari katalog sebelum memesan” sebagai satu titik pemeriksaan, bukan alasan untuk mengubah banyak hal sekaligus. Catat hasil, waktu, dan nomor terkait, lalu lakukan hanya satu langkah yang beralasan.

Gunakan partnerOrderNo idempoten

Buat partnerOrderNo stabil untuk setiap upaya bisnis. Nomor dan parameter sama memberi hasil logis sama; parameter berbeda ditolak.

Untuk “Dasar integrasi Partner API”, perlakukan “Gunakan partnerOrderNo idempoten” sebagai satu titik pemeriksaan, bukan alasan untuk mengubah banyak hal sekaligus. Catat hasil, waktu, dan nomor terkait, lalu lakukan hanya satu langkah yang beralasan.

Terapkan maxPrice dengan benar

Activation createOrder wajib memakai maxPrice dan ditolak sebelum dana ditahan jika harga lebih tinggi. Rental V1 tidak menerima maxPrice.

Untuk “Dasar integrasi Partner API”, perlakukan “Terapkan maxPrice dengan benar” sebagai satu titik pemeriksaan, bukan alasan untuk mengubah banyak hal sekaligus. Catat hasil, waktu, dan nomor terkait, lalu lakukan hanya satu langkah yang beralasan.

Kueri pesanan lama

Setelah timeout ambigu, kueri referensi sama dan jangan membuat partnerOrderNo baru. Gunakan pagination terbatas.

Untuk “Dasar integrasi Partner API”, perlakukan “Kueri pesanan lama” sebagai satu titik pemeriksaan, bukan alasan untuk mengubah banyak hal sekaligus. Catat hasil, waktu, dan nomor terkait, lalu lakukan hanya satu langkah yang beralasan.

Tangani code dan traceId

Pakai error code stabil untuk logika dan simpan traceId untuk dukungan. Jangan mengurai message manusia untuk otomatisasi.

Untuk “Dasar integrasi Partner API”, perlakukan “Tangani code dan traceId” sebagai satu titik pemeriksaan, bukan alasan untuk mengubah banyak hal sekaligus. Catat hasil, waktu, dan nomor terkait, lalu lakukan hanya satu langkah yang beralasan.

Daftar pemeriksaan praktis

1. Verifikasi “Buat API key aktif”, simpan hasilnya, dan lanjutkan hanya bila tindakan berikutnya sudah jelas.
2. Verifikasi “Atur daftar IP wajib”, simpan hasilnya, dan lanjutkan hanya bila tindakan berikutnya sudah jelas.
3. Verifikasi “Gunakan X-API-Key”, simpan hasilnya, dan lanjutkan hanya bila tindakan berikutnya sudah jelas.
4. Verifikasi “Cari katalog sebelum memesan”, simpan hasilnya, dan lanjutkan hanya bila tindakan berikutnya sudah jelas.
5. Verifikasi “Gunakan partnerOrderNo idempoten”, simpan hasilnya, dan lanjutkan hanya bila tindakan berikutnya sudah jelas.
6. Verifikasi “Terapkan maxPrice dengan benar”, simpan hasilnya, dan lanjutkan hanya bila tindakan berikutnya sudah jelas.
7. Verifikasi “Kueri pesanan lama”, simpan hasilnya, dan lanjutkan hanya bila tindakan berikutnya sudah jelas.
8. Verifikasi “Tangani code dan traceId”, simpan hasilnya, dan lanjutkan hanya bila tindakan berikutnya sudah jelas.

Status akhir platform dan riwayat akun adalah sumber kebenaran. Jangan mengirim kata sandi, kode verifikasi lengkap, rahasia autentikasi, access token, API key, atau dokumen yang belum disamarkan. Panduan lain tersedia di Pusat Bantuan MangoOTP.