Panduan Pengembang: Mengoptimalkan Panggilan API Didit untuk Caching Edge CDN

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 throttling sisi klien.

Terapkan Exponential BackoffUntuk respons 429, integrasikan strategi exponential backoff (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 performa yang dirasakan.

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

Dalam lanskap digital yang bergerak cepat saat ini, setiap milidetik berarti. Bagi pengembang yang mengintegrasikan layanan verifikasi identitas, mengoptimalkan panggilan API untuk kecepatan dan efisiensi adalah yang terpenting. Meskipun 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 pengoptimalan 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, sering kali melibatkan produk Verifikasi ID atau Estimasi Usia Didit) dibatasi hingga 600 permintaan per menit. Mengambil keputusan sesi (`GET /v2/session//decision/) dibatasi hingga 100 permintaan per menit untuk mencegah polling berlebihan, dan pembuatan PDF (GET /session//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 Throttling 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: Implementasikan 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. Exponential Backoff untuk 429s: Ini adalah strategi yang sangat penting. Jika aplikasi Anda menerima respons 429, aplikasi harus berhenti sejenak sebelum mencoba kembali permintaan. Alih-alih mencoba kembali segera, implementasikan algoritma exponential backoff. 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. Log 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 pengoptimalan atau menunjukkan kebutuhan untuk meminta batas yang lebih tinggi dari dukungan Didit untuk kasus penggunaan tertentu.

Peran Caching Edge CDN dalam Performa API

Meskipun API verifikasi identitas inti Didit, seperti yang 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 membutuhkan komputasi baru), CDN masih memainkan peran dalam kinerja aplikasi Anda secara keseluruhan.

CDN unggul dalam menyimpan konten statis (gambar, JavaScript, file CSS, video) di lokasi edge yang lebih dekat ke pengguna Anda. Dengan menyajikan 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 Performa Tak Tertandingi

Didit dibangun dari awal sebagai platform identitas AI-native, developer-first. 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 panggilan API ke endpoint verifikasi Didit diarahkan ke pusat data terdekat, meminimalkan waktu perjalanan jaringan.
• Dioptimalkan untuk Real-time: Produk seperti Kehidupan Pasif & Aktif dan Pencocokan Wajah 1:1 dirancang untuk pemrosesan real-time, memanfaatkan model AI canggih yang dieksekusi 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 Developer-First: 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 developer-first ini.

Dengan berfokus pada praktik konsumsi API yang efisien, seperti penanganan batas laju yang cerdas dan exponential backoff, 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 spesifik seperti Verifikasi ID (dengan dukungan OCR, MRZ, dan barcode), Kehidupan Pasif & Aktif, Pencocokan Wajah 1:1, 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 untuk 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.