Panduan Pengembang: Mengoptimalkan Panggilan API Didit untuk Caching Edge CDN (ID-1)

Pahami Batas LajuDidit menerapkan batas laju global dan spesifik endpoint untuk menjaga stabilitas API, menyediakan header X-RateLimit-Limit, X-RateLimit-Remaining, dan X-RateLimit-Reset untuk pembatasan sisi klien.

Terapkan Backoff EksponensialUntuk respons 429, integrasikan strategi backoff eksponensial (misalnya, 5s → 10s → 20s) untuk menangani kelebihan beban API sementara dengan anggun dan mencegah pelanggaran batas laju sisi klien.

Manfaatkan CDN untuk Aset StatisMeskipun API inti Didit tidak dapat di-cache oleh CDN tradisional, optimalkan aset statis aplikasi Anda (JS, CSS, gambar) melalui CDN untuk mengurangi waktu muat dan meningkatkan kinerja yang dirasakan.

Arsitektur Kinerja DiditInfrastruktur AI-native Didit yang terdistribusi secara global secara inheren menawarkan latensi rendah dan ketersediaan tinggi, menjadikannya pilihan ideal untuk kebutuhan verifikasi identitas yang kritis terhadap kinerja.

Dalam lanskap digital yang bergerak cepat saat ini, setiap milidetik sangat berarti. Bagi pengembang yang mengintegrasikan layanan verifikasi identitas, mengoptimalkan panggilan API untuk kecepatan dan efisiensi adalah yang terpenting. Sementara Content Delivery Networks (CDN) sering dikaitkan dengan caching aset statis, memahami cara terbaik berinteraksi dengan layanan API, terutama yang dirancang untuk operasi dinamis dan real-time seperti verifikasi identitas, sangat penting untuk kinerja aplikasi secara keseluruhan. Panduan ini membahas optimasi integrasi API Didit Anda, berfokus pada pembatasan laju, pola panggilan yang efisien, dan bagaimana arsitektur Didit secara inheren mendukung kinerja tinggi.

Memahami Batas Laju API Didit

Didit, seperti layanan API tangguh lainnya, menerapkan batas laju untuk memastikan stabilitas dan penggunaan yang adil di semua klien. Batas ini sangat penting untuk mencegah penyalahgunaan dan menjaga kinerja yang konsisten. Memahami dan mematuhinya adalah langkah pertama menuju interaksi API yang optimal.

Didit menerapkan beberapa lapisan pembatasan laju:

• Batas Global: Untuk endpoint GET umum, ada batas 300 permintaan per menit per aplikasi. Demikian pula, endpoint POST, PATCH, dan DELETE (tulis/hapus) juga memiliki batas global 300 permintaan per menit per aplikasi.
• Batas Spesifik Endpoint: Operasi berdampak tinggi tertentu memiliki batas yang lebih ketat. Misalnya, POST /v2/session/ (untuk membuat sesi verifikasi, seringkali melibatkan produk Verifikasi ID atau Estimasi Usia Didit) dibatasi hingga 600 permintaan per menit. Mengambil keputusan sesi (GET /v2/session/<id>/decision/) dibatasi hingga 100 permintaan per menit untuk mencegah polling berlebihan, dan pembuatan PDF (GET /session/<id>/generate-pdf/) juga dibatasi hingga 100 permintaan per menit karena sifatnya yang intensif CPU.

Ketika batas laju terlampaui, API Didit merespons dengan kode status 429 Too Many Requests. Yang terpenting, respons ini menyertakan header yang membantu:

• X-RateLimit-Limit: Jumlah maksimum permintaan yang diizinkan.
• X-RateLimit-Remaining: Jumlah permintaan yang tersisa di jendela saat ini.
• X-RateLimit-Reset: Waktu (dalam detik epoch) ketika jendela batas laju saat ini diatur ulang.

Dengan memantau header ini, aplikasi Anda dapat secara proaktif membatasi diri, mencegah kesalahan 429 yang tidak perlu dan memastikan alur operasional yang lebih lancar untuk layanan seperti Penyaringan AML atau Deteksi Kehidupan Didit.

Menerapkan Pembatasan dan Backoff Sisi Klien yang Cerdas

Penanganan batas laju sisi klien yang efektif sangat penting untuk integrasi yang tangguh. Berikut caranya:

1. Perhatikan Header Batas Laju: Terapkan logika untuk membaca header X-RateLimit-Remaining. Ketika nilai ini turun di bawah ambang batas tertentu (misalnya, 15% dari X-RateLimit-Limit), klien Anda harus mulai memperlambat laju permintaannya.

2. Backoff Eksponensial untuk 429s: Ini adalah strategi yang sangat penting. Jika aplikasi Anda menerima respons 429, ia harus berhenti sejenak sebelum mencoba lagi permintaan tersebut. Daripada mencoba lagi secara instan, terapkan algoritma backoff eksponensial. Misalnya, tunggu 5 detik, lalu 10 detik, lalu 20 detik, dan seterusnya. Ini mencegah API kewalahan lebih lanjut dan memungkinkan jendela batas laju untuk diatur ulang. Header Retry-After Didit juga dapat menginformasikan strategi backoff Anda.

3. Catat dan Peringatan: Catat kapan batas laju tercapai dan kapan percobaan ulang dipicu. Ini memberikan wawasan berharga tentang pola penggunaan aplikasi Anda dan dapat membantu mengidentifikasi area untuk optimasi atau menunjukkan kebutuhan untuk meminta batas yang lebih tinggi dari dukungan Didit untuk kasus penggunaan tertentu.

Peran Caching Edge CDN dalam Kinerja API

Meskipun API verifikasi identitas inti Didit, seperti untuk Verifikasi ID, Pencocokan Wajah 1:1, atau Verifikasi NFC, melibatkan pemrosesan dinamis dan real-time yang tidak dapat di-cache secara efektif oleh CDN (karena setiap permintaan unik dan memerlukan komputasi baru), CDN masih memainkan peran dalam kinerja aplikasi Anda secara keseluruhan.

CDN unggul dalam caching konten statis (gambar, JavaScript, file CSS, video) di lokasi edge yang lebih dekat dengan pengguna Anda. Dengan menyajikan aset-aset ini dari CDN, Anda mengurangi beban pada server asal Anda dan mengurangi latensi bagi pengguna Anda. Ini meningkatkan kinerja yang dirasakan aplikasi Anda, membuat pengalaman keseluruhan, termasuk alur verifikasi identitas, terasa jauh lebih cepat dan lebih responsif.

Misalnya, jika aplikasi Anda menggunakan alur kerja Didit yang melibatkan antarmuka pengguna berbasis web (misalnya, untuk mengumpulkan unggahan dokumen atau selfie deteksi kehidupan), aset statis untuk UI tersebut dapat disajikan melalui CDN. Meskipun panggilan API ke backend Didit untuk memproses verifikasi bersifat langsung, kecepatan lingkungan aplikasi di sekitarnya secara signifikan memengaruhi kepuasan pengguna.

Arsitektur AI-Native Didit untuk Kinerja Tak Tertandingi

Didit dibangun dari awal sebagai platform identitas AI-native, yang mengutamakan pengembang. Pilihan arsitektur ini secara inheren memberikan keuntungan kinerja yang signifikan yang melengkapi strategi CDN Anda untuk aset statis:

• Distribusi Global: Infrastruktur Didit didistribusikan secara global, memastikan latensi rendah bagi pengguna terlepas dari lokasi geografis mereka. Ini berarti bahwa panggilan API ke endpoint verifikasi Didit diarahkan ke pusat data terdekat, meminimalkan waktu perjalanan jaringan.
• Dioptimalkan untuk Real-time: Produk seperti Passive & Active Liveness dan 1:1 Face Match dirancang untuk pemrosesan real-time, memanfaatkan model AI canggih yang mengeksekusi dengan cepat dan efisien.
• Skalabilitas: Arsitektur modular Didit dibangun untuk skala, mampu menangani volume permintaan verifikasi yang tinggi tanpa penurunan kinerja, bahkan selama periode puncak. Ini sangat penting untuk aplikasi yang membutuhkan throughput tinggi untuk layanan seperti Verifikasi Telepon & Email atau Bukti Alamat.
• API yang Mengutamakan Pengembang: API yang bersih dan terdokumentasi dengan baik memastikan bahwa pengembang dapat berintegrasi secara efisien, mengurangi waktu pengembangan dan potensi kemacetan kinerja terkait integrasi. Proses pendaftaran terprogram, yang hanya membutuhkan dua panggilan API, mencontohkan pendekatan yang mengutamakan pengembang ini.

Dengan berfokus pada praktik konsumsi API yang efisien, seperti penanganan batas laju yang cerdas dan backoff eksponensial, Anda dapat sepenuhnya memanfaatkan backend AI-native berkinerja tinggi Didit untuk memberikan pengalaman verifikasi identitas yang mulus dan cepat.

Bagaimana Didit Membantu

Didit dirancang untuk memberikan pengalaman verifikasi identitas yang berkinerja tinggi dan andal. Platform AI-native kami menawarkan arsitektur modular, memungkinkan Anda untuk mengintegrasikan primitif identitas tertentu seperti Verifikasi ID (dengan dukungan OCR, MRZ, dan barcode), Passive & Active Liveness, 1:1 Face Match, dan Penyaringan & Pemantauan AML sesuai kebutuhan. Modularitas ini berarti Anda hanya menggunakan sumber daya yang Anda butuhkan, mengoptimalkan biaya dan kinerja. Penawaran KYC Inti Gratis Didit, tanpa biaya pengaturan dan model bayar-per-pemeriksaan-berhasil, membuatnya sangat mudah untuk memulai. Infrastruktur kami yang terdistribusi secara global memastikan bahwa panggilan API Anda mendapatkan manfaat dari latensi rendah dan ketersediaan tinggi, membuat kebutuhan akan caching CDN tradisional dari respons API kurang relevan, karena sifat dinamis verifikasi identitas menuntut pemrosesan real-time. Kami memberdayakan pengembang dengan solusi yang kuat dan terukur yang secara inheren memprioritaskan kecepatan dan efisiensi, memungkinkan Anda untuk fokus membangun aplikasi hebat sementara kami menangani kompleksitas kepercayaan identitas.

Siap Memulai?

Siap melihat Didit beraksi? Dapatkan demo gratis hari ini.

Mulai verifikasi identitas secara gratis dengan tingkat gratis Didit.