Mendebug Integrasi Didit: Kesalahan Umum & Strategi Mengatasinya (ID)

Masalah Kunci API dan AutentikasiPastikan kunci API Anda dikonfigurasi dengan benar dan variabel lingkungan diatur dengan tepat, karena kegagalan autentikasi adalah rintangan awal yang umum untuk setiap integrasi API.

Pembatasan Laju dan ThrottlingImplementasikan penanganan batas laju yang kuat dengan backoff eksponensial dan pantau header X-RateLimit untuk mencegah gangguan layanan dan memastikan stabilitas aplikasi.

Manajemen Siklus Hidup SesiPahami siklus hidup lengkap sesi verifikasi Didit, mulai dari pembuatan dan pembaruan status hingga pengambilan keputusan, untuk melacak kemajuan verifikasi pengguna secara akurat.

Pendekatan Developer-First DiditDidit menyediakan dokumentasi komprehensif, sandbox instan, dan API yang bersih, secara signifikan menyederhanakan proses debugging dan mengurangi kompleksitas integrasi bagi developer.

Mengintegrasikan verifikasi identitas ke dalam aplikasi Anda adalah langkah penting untuk keamanan dan kepatuhan. Namun, seperti sistem kompleks lainnya, berintegrasi dengan platform identitas seperti Didit dapat menghadirkan tantangan debugging yang unik. Panduan ini dirancang untuk membantu developer mengidentifikasi dan mengatasi kesalahan umum, memastikan proses integrasi yang lancar dan efisien dengan layanan verifikasi identitas Didit yang canggih.

Memahami Autentikasi dan Konfigurasi API

Salah satu titik awal paling sering untuk masalah integrasi terletak pada autentikasi dan konfigurasi API. Kunci API yang salah konfigurasi, variabel lingkungan yang tidak benar, atau pembatasan akses jaringan semuanya dapat menyebabkan kesalahan autentikasi yang membuat frustrasi.

Kesalahan Umum:

• Kunci API Tidak Benar: Pastikan kunci API yang digunakan dalam permintaan Anda cocok dengan yang disediakan di Didit Business Console Anda. Ingat bahwa kunci API peka huruf besar/kecil.
• Masalah Variabel Lingkungan: Jika Anda menyimpan kunci API Anda dalam variabel lingkungan (misalnya, DIDIT_API_KEY), periksa kembali apakah kunci tersebut dimuat dengan benar dan dapat diakses oleh aplikasi Anda saat runtime.
• Izin: Verifikasi bahwa kunci API memiliki izin yang diperlukan untuk operasi yang ingin Anda lakukan. Beberapa operasi mungkin memerlukan cakupan tertentu.
• Pembatasan Jaringan: Firewall atau server proxy terkadang dapat memblokir panggilan API keluar. Pastikan server Anda memiliki akses tanpa batas ke titik akhir API Didit.

Strategi Pemecahan Masalah:

• Periksa Kembali Kredensial: Solusi paling sederhana seringkali yang paling efektif. Salin dan tempel kunci API Anda langsung dari Didit Business Console untuk menghindari kesalahan ketik.
• Gunakan Alat Seperti cURL atau Postman: Sebelum berintegrasi ke dalam basis kode Anda, uji kunci API Anda dengan perintah cURL langsung atau permintaan Postman untuk mengisolasi masalah autentikasi dari bug tingkat aplikasi.
• Periksa Pesan Kesalahan: API Didit menyediakan pesan kesalahan yang jelas. Respons 401 Unauthorized atau 403 Forbidden biasanya menunjukkan masalah autentikasi atau izin.
• Konsultasikan Dokumentasi Didit: Referensi API Didit menyediakan informasi terperinci tentang metode autentikasi dan header yang diharapkan.

Menangani Batas Laju dan Throttling API

Untuk menjaga stabilitas dan penggunaan yang adil, Didit, seperti kebanyakan penyedia API yang kuat, menerapkan pembatasan laju. Kegagalan untuk memperhitungkan batas ini dapat menyebabkan gangguan layanan sementara dan kesalahan 429 Too Many Requests.

Kesalahan Umum:

• Permintaan Berlebihan (Bursting Requests): Mengirimkan sejumlah besar permintaan dalam waktu singkat, terutama untuk operasi yang membutuhkan banyak sumber daya seperti membuat sesi atau mengambil keputusan, dapat dengan cepat mencapai batas. Misalnya, POST /v2/session/ memiliki batas 600 permintaan per menit, sedangkan GET /v2/session/<id>/decision/ dibatasi hingga 100 permintaan per menit untuk mencegah polling yang berlebihan.
• Mengabaikan Header Batas Laju: Tidak memantau header X-RateLimit-Limit, X-RateLimit-Remaining, dan X-RateLimit-Reset dapat menyebabkan throttling yang tidak terduga.
• Kurangnya Backoff Eksponensial: Tanpa strategi backoff eksponensial, mencoba kembali segera setelah kesalahan 429 kemungkinan akan mengakibatkan kegagalan berkelanjutan.

Strategi Pemecahan Masalah:

• Pantau Header: Selalu parse dan respons terhadap header batas laju yang disediakan dalam respons API Didit. Ini memungkinkan aplikasi Anda untuk melakukan self-throttling secara proaktif.
• Implementasikan Backoff Eksponensial: Ketika Anda menerima respons 429, tunggu waktu yang semakin lama sebelum mencoba kembali permintaan. Pola umum adalah 5s → 10s → 20s → 40s.
• Operasi Batch: Jika memungkinkan, batch operasi tertentu atau rancang alur kerja Anda untuk mengurangi frekuensi panggilan API.
• Pembatasan Laju Terdistribusi: Jika Anda memiliki beberapa instans aplikasi, pertimbangkan mekanisme pembatasan laju terpusat untuk menghindari melebihi batas global dari instans yang terpisah.

Mengelola Siklus Hidup Sesi Verifikasi

Proses verifikasi identitas Didit berpusat pada sesi. Memahami cara membuat, mengelola, dan mengambil hasil dari sesi ini adalah hal yang mendasar. Masalah sering muncul karena kesalahpahaman status sesi atau penanganan yang tidak tepat terhadap alur verifikasi asinkron.

Kesalahan Umum:

• Pembuatan Sesi yang Salah: Tidak menyediakan semua parameter yang diperlukan saat memanggil didit_create_session atau menggunakan ID alur kerja yang tidak valid dapat mencegah sesi dimulai dengan benar.
• Polling Terlalu Sering: Berulang kali memanggil didit_get_session_decision tanpa penundaan yang memadai dapat mencapai batas laju dan membuang sumber daya.
• Tidak Menangani Semua Hasil Sesi: Sesi dapat memiliki berbagai status (misalnya, pending, approved, declined, resubmission_requested), dan aplikasi Anda harus siap untuk menangani setiap status.
• Miskonfigurasi Webhook: Bergantung semata-mata pada polling daripada webhook untuk pembaruan sesi dapat menimbulkan latensi dan kompleksitas. Jika menggunakan webhook, pastikan webhook dikonfigurasi dengan benar dan titik akhir Anda dapat dijangkau dan responsif.

Strategi Pemecahan Masalah:

• Tinjau Konfigurasi Alur Kerja: Gunakan didit_get_workflow untuk memeriksa konfigurasi alur kerja verifikasi Anda, memastikan alur kerja tersebut selaras dengan langkah-langkah verifikasi yang Anda harapkan (misalnya, Verifikasi ID, Liveness Pasif & Aktif, Pencocokan Wajah 1:1).
• Manfaatkan Webhook Didit: Konfigurasi webhook untuk menerima pembaruan waktu nyata tentang perubahan status sesi. Ini adalah cara paling efisien untuk mengelola hasil verifikasi asinkron. Validasi tanda tangan webhook Anda untuk memastikan keaslian permintaan masuk.
• Catat ID Sesi: Selalu catat session_id Didit saat sesi dibuat. ID ini sangat penting untuk debugging dan mengambil informasi terperinci nanti menggunakan alat seperti didit_get_session_decision.
• Uji Kasus Batas: Simulasikan berbagai hasil, termasuk verifikasi yang berhasil, penolakan, dan kasus yang memerlukan pengajuan ulang, untuk memastikan aplikasi Anda menangani semua kemungkinan dengan baik.

Bagaimana Didit Membantu

Didit dirancang dengan mempertimbangkan developer, menawarkan serangkaian fitur yang secara signifikan menyederhanakan integrasi dan debugging. Platform identitas modular berbasis AI kami menyediakan alat yang kuat untuk mencegah dan menyelesaikan masalah integrasi umum.

• Desain Developer-First: Didit menawarkan sandbox instan, dokumentasi publik yang komprehensif, dan API yang bersih, sehingga mudah untuk memulai dan memecahkan masalah. Pendekatan API-first kami berarti Anda dapat mengelola setiap aspek verifikasi identitas secara terprogram.
• Arsitektur Modular: Primitif identitas kami yang dapat disusun, termasuk Verifikasi ID (OCR, MRZ, barcode), Liveness Pasif & Aktif, Pencocokan Wajah 1:1, dan Penyaringan AML, memungkinkan Anda membangun dan menguji alur verifikasi secara bertahap, mengisolasi potensi masalah ke modul tertentu.
• Alur Kerja Terorkestrasi: Didit Business Console tanpa kode memungkinkan Anda mengonfigurasi dan menguji alur kerja KYC yang kompleks secara visual, mengurangi kemungkinan kesalahan logika dalam integrasi Anda.
• Integrasi Agen AI (MCP Server): Didit dibangun untuk era agen. Server Model Context Protocol (MCP) kami memungkinkan agen pengodean AI untuk berinteraksi langsung dengan platform, mengotomatiskan tugas-tugas seperti pendaftaran akun, konfigurasi alur kerja, dan manajemen sesi, semakin mengurangi kesalahan manual dan mempercepat debugging.
• KYC Inti Gratis: Mulai verifikasi identitas tanpa biaya di muka, memungkinkan pengujian dan debugging ekstensif di lingkungan seperti produksi tanpa hambatan finansial. Model pembayaran per pemeriksaan yang berhasil, tanpa biaya pengaturan, memastikan Anda hanya membayar untuk apa yang Anda gunakan.
• Pelaporan Kesalahan Terperinci: API Didit menyediakan pesan kesalahan yang jelas dan dapat ditindaklanjuti, memandu Anda langsung ke akar masalah.

Siap Memulai?

Siap melihat Didit beraksi? Dapatkan demo gratis hari ini.

Mulai verifikasi identitas secara gratis dengan tingkat gratis Didit.