Ücretsiz pasaport OCR API'si

İlk tanımanızı hesap olmadan yapın

Anahtarı dokümantasyondan kopyalayın ve bir görüntü gönderin. Entegrasyonun tamamı bu kadar:

IMG=$(base64 -i passport.jpg | tr -d '\n')

curl -s https://api.doc.cheap/v1/scans \
  -H "Authorization: Bearer sk_sandbox_public" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: first-call-1" \
  -d '{"image":"'"$IMG"'","options":{"mode":"full"}}'

sk_sandbox_public herkese açık sandbox anahtarıdır: bilerek yayımlanır, gizli değildir ve istek sınırı vardır. Idempotency-Key, yeniden denenen bir isteğin ikinci kez ücretlendirilmeyeceği anlamına gelir; bu da bir kuyruğu yeniden oynattığınız gün önem kazanır.

Neler döner

Tek bir yanıt yapısı, sekiz grup, her anahtar her zaman mevcut. Alan gezgini her anahtarı türüyle birlikte listeler; API referansı (İngilizce) ise sözleşmenin kendisidir.

{
  "meta": { "schema_version": "1.0", "status": "recognized", "billed": true,
            "confidence": "high",
            "timing": { "upload_ms": 118, "processing_ms": 684, "total_ms": 826 } },
  "document": { "kind": "passport", "country": "GRC", "country_name": "Greece",
                "number": "AM7304518", "series": null,
                "issue_date": "2022-03-10", "expiry_date": "2032-03-10",
                "is_expired": false, "days_remaining": 2001 },
  "holder": { "given_names": "ELENI SOFIA", "surname": "PARADEIGMA",
              "birth_date": "1994-03-08", "sex": "F", "nationality": "GRC" },
  "mrz": { "status": "passed", "reason": null, "lines": ["…", "…"] },
  "fields": [ "…" ], "images": { "…": null },
  "quality": { "overall": "pass" },
  "authenticity": { "overall": "not_checked", "checks": [] }
}

• meta.status tam olarak beş dizeden biridir: recognized, no_document_found, unreadable, unsupported_document, rejected.
• Tarihler her zaman ISO-8601 biçimindedir. Eksik bir değer null olur, asla eksik bir anahtar olmaz.
• meta.billed her yanıtta bulunur ve o çağrının bir ücret doğurup doğurmadığını söyler.
• fields[], belgenin taşıdığı her alanı içerir; alanlar kodlanmış bölgeden ve basılı bölgeden ayrı ayrı, her biri kendi güven düzeyiyle okunur, böylece iki okuma karşılaştırılabilir. Kendi yazı sistemindeki değerler, Latin harfli transliterasyonun yanında, dilleriyle etiketlenmiş olarak gelir.

Örnekteki hamil sentetik bir numunedir: uydurma değerler üzerinde gerçek kontrol basamağı aritmetiği taşıyan, uydurma bir kişi. Taşıdığı bölge MRZ formatları sayfasında ayrıntılı olarak açıklanır.

Ücretsiz çağrılardan sonra ne kadar tutar

Görüntüye ne olur

Sandbox anahtarında hiçbir şey saklanmaz. Görüntü hiçbir zaman diske yazılmaz – istek süresince bellekte yaşar – ve sonuç da saklanmaz. Kendi live anahtarınızla bir sonuç, yeniden okuyabilmeniz için tutulur: isteğin belirttiği retain_hours süresince ya da belirtilmezse hesabınızın saklama ayarı boyunca; bu süre siz değiştirene kadar bir yıldır (8760 saat).

Hiçbir şey saklanmasın istiyorsanız retain_hours: 0 gönderin – saklanan sonuç yok, sonradan geri çekilecek bir şey yok. Seçim sizindir, her çağrıda ayrı ayrı.

Fotoğraf okunamadığında

Yanıt bunu açıkça söyler ve ücretsizdir. meta.status durumları birbirinden ayırır ve üçünde de meta.billed false olur:

• no_document_found – karede belgeye benzeyen hiçbir şey yok.
• unreadable – belge bulundu ama okunamadı – parlama, bulanıklık, çözünürlük.
• unsupported_document – belge okundu ama bu tür desteklenmiyor.

Her yanıt kendi süre dökümünü taşır; canlı medyan burada vaat edilmek yerine durum sayfasında yayımlanır.

Hiç anahtar gerektirmeyen ücretsiz araçlar

• MRZ ayrıştırıcı – bir TD1, TD2 veya TD3 bölgesini yapıştırın, her alanı ve her kontrol basamağını görün. Tarayıcınızda çalışır.
• MRZ oluşturucu – test için geçerli bir bölge oluşturun.
• Belge alanı gezgini – API'nin yanıtlarında kullandığı alan sözlüğüne göz atın.

Kod yerine bir asistandan mı çağıracaksınız? MCP sunucusu aynı tanımayı üç araç olarak sunar.