GET /v1/requests/{request_id}

Asenkron doğrulama veya gecikmeli işlemlerden sonra sonucu almak için bu uç noktayı kullanın. Yanıt her zaman size ait uygulama ve istek ile sınırlıdır. Sync/async seçimi için karar rehberine bakın.

Polling stratejisi

Önerilen bekleme süreleri (saniye): 2, 4, 8, 16 (üstel geri çekilme). Toplam bekleme yaklaşık 30 sn’yi aşmamalıdır; sonrasında webhook veya panel üzerinden kontrol etmeyi düşünün.

Durum değerleri

• processing — İstek hâlâ işleniyor; kısa aralıkla tekrar deneyin.
• completed — Tamamlandı; result nesnesinde verified ve from_cache yer alır.
• failed — Başarısız; error nesnesinde kod ve mesaj döner.

Örnek: tamamlandı (200)

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "reference_id": null,
  "status": "completed",
  "created_at": "2026-03-31T12:00:00+00:00",
  "result": {
    "verified": true,
    "from_cache": false,
    "processed_at": "2026-03-31T12:00:05+00:00"
  },
  "credits": {
    "used": 1,
    "remaining": 499
  }
}

credits yalnızca production uygulamalarında döner.

Örnek: işleniyor

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "reference_id": null,
  "status": "processing",
  "created_at": "2026-03-31T12:00:00+00:00"
}

Örnek: başarısız

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "reference_id": null,
  "status": "failed",
  "created_at": "2026-03-31T12:00:00+00:00",
  "error": {
    "code": "verification_error",
    "message": "Doğrulama işlemi tamamlanamadı."
  }
}

cURL örneği

REQ_ID="550e8400-e29b-41d4-a716-446655440000"
DELAY=2
for i in 1 2 3 4 5; do
  curl -sS "$BASE_URL/v1/requests/$REQ_ID" \
    -H "Authorization: Bearer $API_KEY" | jq .
  sleep $DELAY
  DELAY=$(( DELAY * 2 ))
done