Secara umum, berikut ini adalah langkah-langkah integrasi dengan Layanan Data Xendit. Perlu diketahui bahwa integrasi hanya dapat dilakukan melalui API dengan menggunakan bahasa pemrograman JSON.

Persiapan

Produk data Iluma menggunakan desain RESTful API agar lebih bersih dan mudah dipahami. Semua permintaan API harus dilakukan melalui HTTPS, bukan HTTP (semua panggilan yang dilakukan melalui HTTP biasa akan gagal). Semua respons API kami akan mengembalikan objek JSON yang dapat digunakan oleh aplikasi Anda. Respons biasanya akan dikirimkan melalui callback, meskipun beberapa produk juga menawarkan GET endpoint yang dapat Anda polling untuk mengambil status permintaan.

Singkatnya, kami memiliki tiga langkah untuk membantu Anda menyiapkan:

• Mendapatkan kode sampel
• Otentikasi permintaan Anda
• Mengatur callback

Untuk semua informasi mendetail tentang langkah-langkahnya, silakan kunjungi dokumentasi kami di sini.

Membuat permintaan / request pertama Anda

Setelah Anda:

• Memiliki kunci API
• Memiliki server callback 
• Telah menyiapkan callback 

Anda sekarang siap untuk mengajukan permintaan ke API produk data Iluma. Daftar titik akhir terbaru tersedia di sini, dengan petunjuk tentang format permintaan dan respons khusus. Format kesalahan umum berlaku di semua endpoint dan tersedia di sini.

Untuk membuat permintaan pertama Anda, pastikan Anda telah mendaftar di Layanan Data Xendit dan mendapatkan akses yang diperlukan. Silakan hubungi AM/SR Anda atau help@xendit.co / help@iluma.ai untuk memulai orientasi dengan XDS.

Penting: Perlu diketahui bahwa semua permintaan yang dibuat di mode pengembangan akan mengenai data dummy.

Untuk informasi terperinci mengenai langkah-langkahnya, Anda dapat mengunjungi dokumentasi kami di sini

Mensimulasikan respons

Saat kami menerima permintaan dengan tajuk "Magic Reply", kami akan mengembalikan respons dengan format tertentu, memungkinkan Anda menyimulasikan muatan respons utama yang akan Anda terima saat meminta sumber daya dengan status tersebut. Jika status respons biasanya memicu callback, ini juga akan dikirim ke server yang Anda tentukan selama penyiapan.

Perhatikan bahwa:

• Permintaan yang dibuat ke endpoint validasi (misalnya: validasi nama e-wallet) akan mencerminkan payload permintaan Anda
• Permintaan yang dibuat ke endpoint  ekstraksi data (mis., OCR kartu ID) akan mengembalikan data dummy
• Validasi format akan diterapkan sebelum menilai header Magic Reply, jadi Anda akan menerima API_VALIDATION_ERROR jika Anda memberikan payload permintaan yang tidak sesuai dengan spesifikasi API
• Header ini tersedia di KEDUA pengembangan dan mode LIVE 
• Permintaan yang dibuat dengan tajuk ini TIDAK akan dikenakan biaya di mode LIVE

Untuk informasi mendetail tentang simulasi respons, Anda dapat mengunjungi dokumentasi kami di sini.

Untuk informasi detail mengenai Magic Reply, Anda dapat mengunjungi dokumentasi kami di sini.