Batas Laju API Didit: Limit, Header & Backoff 429

​

Identifier dan pengecualian

1. Header x-api-key → penghitung berbasis kunci.
2. Hop pertama X-Forwarded-For → penghitung berbasis IP.
3. REMOTE_ADDR → penghitung berbasis IP.

• Kunci internal DIDIT_WEBAPP_API_KEY (hanya digunakan oleh konsol Didit).
• Endpoint yang dilindungi oleh izin IsValidSession (lalu lintas sesi embedded/SDK).
• GET /system/healthcheck (dilayani oleh HealthMiddleware sebelum tumpukan ini).
• Webhook penyedia: Stripe, skrining AML, callback verifikasi wajah, perubahan daftar KYC.

​

Batas global

​

Batas khusus endpoint

​

Bentuk respons 429

HTTP/1.1 429 Too Many Requests
Content-Type: application/json
X-RateLimit-Limit: 600
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1762534870
Retry-After: 37

{
  "detail": "Session creation rate limit exceeded. You can make up to 600 requests per minute."
}

​

Panduan untuk klien

• Hormati Retry-After sebagai batas minimum backoff Anda. Di atasnya, terapkan exponential backoff dengan jitter (5s → 10s → 20s → 40s ± random) agar dua klien yang menerima 429 pada waktu yang sama tidak tersinkron.
• Hentikan percobaan ulang setelah mencapai batas maksimum yang rendah (misalnya 5 percobaan). Teruskan error ke pemanggil dan beri tahu tim Anda. 429 yang terus-menerus biasanya berarti loop yang tidak terkendali, bukan lonjakan sesaat.
• Gunakan satu pengidentifikasi per beban kerja. Berbagi x-api-key di banyak backend menggabungkannya ke penghitung yang sama, yang dapat membuat satu backend yang ramai dapat membuat yang lainnya kehabisan jatah. Buat aplikasi terpisah (dan karenanya api_key terpisah) untuk setiap lingkungan, merek, atau pelanggan. Lihat Pendaftaran terprogram.
• Simpan hasil baca keputusan dalam cache. Endpoint /decision/ tidak dirancang untuk loop polling yang rapat. Jika Anda memerlukan pembaruan real-time, gunakan Webhook dan hanya panggil GET /v3/session/<id>/decision/ untuk pengisian data susulan atau audit.
• Buat PDF secara offline. Rendering PDF bersifat intensif CPU (batas 50/menit). Picu pembuatan PDF dari antrean setelah sesi mencapai status terminal, bukan pada setiap tampilan halaman.

​

Contoh klien yang menangani 429

async function postSession(body) {
  for (let attempt = 0; attempt < 5; attempt++) {
    const res = await fetch("https://verification.didit.me/v3/session/", {
      method: "POST",
      headers: {
        "x-api-key": process.env.DIDIT_API_KEY,
        "Content-Type": "application/json",
      },
      body: JSON.stringify(body),
    });

    if (res.status !== 429) return res;

    const retryAfter = Number(res.headers.get("Retry-After") ?? "1");
    const jitter = Math.random() * 1000;
    await new Promise((r) => setTimeout(r, retryAfter * 1000 + jitter));
  }
  throw new Error("Didit: too many 429s, giving up");
}

import os
import random
import time

import httpx

def post_session(body: dict) -> httpx.Response:
    with httpx.Client(timeout=15) as client:
        for _ in range(5):
            resp = client.post(
                "https://verification.didit.me/v3/session/",
                headers={
                    "x-api-key": os.environ["DIDIT_API_KEY"],
                    "Content-Type": "application/json",
                },
                json=body,
            )
            if resp.status_code != 429:
                return resp
            wait_s = float(resp.headers.get("Retry-After", "1")) + random.random()
            time.sleep(wait_s)
    raise RuntimeError("Didit: too many 429s, giving up")

​

Butuh kapasitas tambahan?