Misfora'nın bir parçası

Pasaport ve Kimlik OCR API'si

Misfora'nın misafir kayıt yazılımının arkasındaki belge tanıma katmanı — bağımsız bir API olarak da sunulur.

Bağımsız olarak kullanın — pasaport ve kimlik tanımayı kendi otelcilik, seyahat, araç kiralama, telekom veya katılım yazılımınıza entegre edin.

Kredi kartı gerekmez. API erişimi manuel olarak kurulur.

POST /v1/scan · image → JSON
{
  "success": true,
  "document": {
    "type": "passport",
    "issuing_country": "TUR",
    "document_number": "U12345678",
    "first_name": "AHMET",
    "last_name": "YILMAZ",
    "...": "..."
  }
}
Ortanca yanıt süresi ~1,1 sn (600–2500 ms)
Her alan ICAO MRZ kontrol rakamlarıyla doğrulanır
Görseller işlendikten sonra silinir — asla saklanmaz
Sorun

Pasaport verilerini elle girdirmeyi bırakın.

Pasaport ya da kimlikten elle girilen her alan bir yazım hatası riskidir — ve aslında hiç harcamanız gerekmeyen birkaç saniyedir.

Misfora Olmadan
  • ⌨️ Personel ismi yazar
  • ⌨️ Belge numarasını yazar
  • ⌨️ Doğum tarihini yazar
  • ⌨️ Son geçerlilik tarihini kontrol eder
  • ❌ Hatalar ve kaybedilen zaman
Misfora İle
  • 📷 Pasaport taranır
  • Misfora OCR API
  • ✓ İsim, belge numarası
  • ✓ Doğum tarihi, son geçerlilik tarihi
  • ✓ Uyruk, belge türü
  • Doğrudan uygulamanıza
Kimler için

Kimlik belgeleriyle çalışan yazılımlar için tasarlandı.

Kullanıcılardan sürekli pasaport ya da kimlik okumasını isteyen her uygulama, kendi OCR altyapısını kurup bakımını üstlenmek yerine aynı API'yi kullanabilir.

🏨

Otel PMS ve misafir yönetimi

Check-in sırasında personelin elle girmesi yerine, misafirin adı, belge numarası, doğum tarihi ve uyruğu pasaport ya da kimlikten otomatik olarak çıkarılır.

🚗

Araç kiralama yazılımı

Müşterinin pasaportunu veya kimliğini tarayın; elde edilen yapılandırılmış sonucu profil ve kiralama sözleşmesini doldurmak için kullanın — daha az yazım, daha az hata.

🏥

Sağlık ve hasta kabulü

Hasta kimlik bilgilerini pasaport ya da kimlik kartından yakalayın ve doğrudan sisteminize aktarın.

✈️

Seyahat ve göçmenlik yazılımları

Manuel veri girişi yerine, yüklenen bir fotoğraftan pasaport bilgilerini otomatik olarak okuyun.

🔐

KYC ve kimlik doğrulama platformları

Belge OCR'ını ve MRZ doğrulamasını, katılım ya da kimlik doğrulama sürecinizin bir adımı olarak kullanın.

🏢

Herhangi bir iş yazılımı

Uygulamanız herhangi bir şekilde kimlik belgesi bilgisi topluyorsa, aynı API elle yapılan adımın yerini alabilir.

Özel entegrasyonlar ve çözümler. Misfora'yı PMS, CRM, ERP veya standart olarak desteklemediğimiz başka bir iş yazılımına bağlayabiliriz.

Nasıl çalışır

Belge fotoğrafından kullanılabilir veriye.

1

Yükleme

Uygulamanız pasaport veya kimlik fotoğrafını API'ye gönderir.

2

Tanıma

Misfora belgeyi tespit eder ve makine tarafından okunabilir bölgesini (MRZ) okur.

3

Doğrulama

Her alan denetlenir — MRZ kontrol rakamları ICAO 9303 standardına göre, ülke ve cinsiyet kodları ise izin verilen değer listelerine göre kontrol edilir.

4

Yapılandırılmış sonuç

Uygulamanız, çıkarılan alanları içeren temiz ve yapılandırılmış bir JSON alır.

5

Sizin iş akışınız

Kaydedin, müşteri profili oluşturun, PMS'inizi güncelleyin, KYC sürecini başlatın, kiralama sözleşmesi oluşturun — uygulamanız ne gerektiriyorsa.

Belge tanıma işini Misfora yapar. Veriyle ne yapılacağına sizin yazılımınız karar verir.

Tek API. Tek yanıt. Bakımını üstlenmeniz gereken bir OCR altyapısı yok.

MRZ çıkarımı Alan bazlı doğrulama İnceleme sinyali Basit JSON yanıtı Senkron API
Yalnızca çıkarım yeterli değil

Sadece çıkarmayın. Sonucu doğrulayın.

pasaport
OCR / MRZ
yapılandırılmış alanlar
alan doğrulama
uygulamanız

Çıkarım size belgenin ne yazdığını söyler. Doğrulama ise ona güvenip güvenemeyeceğinizi söyler.

Her alan bir geçti/kaldı kontrolüyle birlikte gelir — ayrıca bir şeyin ikinci kez incelenmeye değer olduğu durumlar için tek bir review_recommended bayrağı eklenir.

Kimlik belgeleri için tasarlandı

Pasaport ve kimlik kartı OCR'ı.

Pasaportlar

ICAO TD3 — 2 satırlı MRZ.

Kimlik kartları

ICAO TD1 — 3 satırlı MRZ.

Otomatik tespit

Belge türü parametresi gerekmez — Misfora belgenin pasaport mu yoksa kimlik kartı mı olduğunu kendisi belirler.

Otomatik hizalama

Döndürme ve perspektif hatalarını otomatik olarak düzeltir — yan çekilmiş ya da baş aşağı fotoğraflar için bir güvenlik ağı görevi görür.

Desteklenen belge ve ülkelerin tam listesine göz atın.

Gizlilik

Belgeleriniz saklanmaz.

Yüklenen belge görselleri yalnızca API isteği süresince var olur ve işlem tamamlanır tamamlanmaz silinir — hiçbir şey veritabanına veya bulut depolamaya yazılmaz. Çıkarılan kimlik alanları da (isim, belge numarası, doğum tarihi) yanıt döndükten sonra saklanmaz.

Görselleriniz ve çıkarılan veriler, herhangi bir OCR modelini eğitmek ya da iyileştirmek için kullanılmaz.

Misfora'yı bir KYC ya da uyumluluk süreci için mi değerlendiriyorsunuz? Faturalama için tuttuğumuz sınırlı kullanım meta verilerinin tamamını dokümantasyondaki Güvenlik bölümünde görebilirsiniz.

Hızlı başlangıç

Tek istek, tek yanıt.

İş oluşturma, sorgulama (polling) ya da webhook yok — dokümantasyondaki Hızlı Başlangıç ile aynı üç örnek.

curl https://misfora.com/v1/scan \
  -H "Authorization: Bearer msf_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
  -F "file=@passport.jpg"
import requests

response = requests.post(
    "https://misfora.com/v1/scan",
    headers={"Authorization": "Bearer msf_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"},
    files={"file": open("passport.jpg", "rb")},
)
response.raise_for_status()
print(response.json())
const fs = require("fs");

const form = new FormData();
form.append("file", fs.readFileSync("passport.jpg"), "passport.jpg");

const res = await fetch("https://misfora.com/v1/scan", {
  method: "POST",
  headers: { Authorization: "Bearer msf_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" },
  body: form,
});
console.log(await res.json());

İstek/yanıt referansının tamamı, tüm alanlar ve tüm hata kodları için dokümantasyonu inceleyin.

Erişim

Standart erişim ve Kurumsal.

Standart erişim

Limitler kullanım senaryonuza göre belirlenir ve hesabınızı kurarken birlikte kararlaştırılır — seçebileceğiniz sabit bir genel paket yoktur.

Kurumsal

Daha yüksek hacim, varsayılan JSON yapısı sisteminize doğrudan uymuyorsa kendi sistemlerinize uyarlanmış bir yanıt şeması ve — talep üzerine — belgeleri dış bir API'ye gönderemeyen ortamlar için tamamen çevrimdışı, şirket içi (on-premise) çalışan bir tanıma motoru.

Fiyatlandırma

Kullanıma dayalı fiyatlandırma.

Planlar, aylık belge işleme hacmine göre belirlenir.

Teklif almak için bizimle iletişime geçin.

Entegre etmeden önce

Entegre etmeden önce deneyin.

Önce nasıl çalıştığını görmek mi istiyorsunuz? Ücretsiz herkese açık tarayıcımızda bir tarama yapın — API ile aynı OCR altyapısı, kayıt gerekmez.

📷Ücretsiz Tarayıcıyı Deneyin
SSS

Sorular

Pasaport OCR API'si nedir?+
Bir pasaport OCR API'si, pasaport (veya kimlik kartı) fotoğrafını okur ve ham metin yerine isim, belge numarası, doğum tarihi gibi bilgileri yapılandırılmış, kullanılabilir alanlar olarak döndürür. Misfora'nın API'si ayrıca her alanın MRZ kontrol rakamını doğrular; böylece verinin kendisiyle birlikte bir veri kalitesi sinyali de elde edersiniz.
API neleri çıkarabilir?+
Belge türü, veren ülke, belge numarası, son geçerlilik tarihi, ad ve soyad, doğum tarihi, uyruk ve cinsiyet. Tam alan listesi ve yanıt şeması için dokümantasyona bakın.
Hangi belgeler destekleniyor?+
Makine tarafından okunabilir bölgeye (MRZ) sahip pasaportlar ve kimlik kartları. Desteklenen belge ve ülkelerin tam listesine göz atın.
Pasaport taramayı kendi PMS'ime entegre edebilir miyim?+
Evet — misafirin pasaport ya da kimlik fotoğrafını PMS'inizden API'ye gönderin ve personelin elle girmesi yerine, elde edilen yapılandırılmış sonucu rezervasyon ya da kayıt bilgisini otomatik olarak doldurmak için kullanın.
Misfora'yı araç kiralama yazılımıyla entegre edebilir miyim?+
Evet — aynı API, kimlik belgesi verisine ihtiyaç duyan her uygulama için çalışır: araç tesliminde müşterinin pasaportunu ya da kimliğini tarayın ve yapılandırılmış sonucu profil ile kiralama sözleşmesini doldurmak için kullanın.
Misfora'yı KYC için kullanabilir miyim?+
Misfora, bir KYC ya da katılım sürecinin belge-OCR adımı olarak kullanılabilir — kimlik belgesi alanlarını çıkarır ve doğrular. Kimlik doğrulama, canlılık tespiti ya da tam bir KYC kararı sunmaz; bunu uyumluluk sürecinizin geri kalanıyla birlikte kullanmanız gerekir.
Tipik bir yanıt ne kadar sürer?+
Kendi testlerimizde, isteklerin çoğu 600–2500 ms arasında, ortanca değer ise yaklaşık 1100 ms'de tamamlanıyor. Gerçek gecikme süresi büyük ölçüde görsel boyutuna ve kalitesine bağlıdır; bu nedenle bunu bir garanti değil, kabaca bir gösterge olarak değerlendirin.
Yüklenen belgeleri saklıyor musunuz?+
Hayır — görseller yalnızca istek süresince var olur ve işlem tamamlanır tamamlanmaz silinir. Hiçbir şey veritabanına veya bulut depolamaya yazılmaz.
API, MRZ kontrol rakamlarını doğruluyor mu?+
Evet, çıkarılan her alan için — tam olarak hangileri olduğunu dokümantasyonda görebilirsiniz.
TD1 ile TD3 arasındaki fark nedir?+
İki MRZ biçimi için ICAO terimleri: TD3, pasaportlarda kullanılan 2 satırlı biçim; TD1 ise kimlik kartlarında kullanılan 3 satırlı biçimdir. API tarafında — TD3 → type: "passport", TD1 → type: "id_card".
Fotoğrafın kusursuz hizalanmış olması gerekiyor mu?+
Hayır — Misfora belgeyi otomatik olarak tespit eder; yan çekilmiş ya da baş aşağı fotoğraflar dahil döndürme ve perspektif hatalarını düzeltir. İyi hizalanmış, iyi aydınlatılmış bir fotoğraf yine de daha güvenilir sonuç verir, ancak bu bir zorunluluk değil, bir güvenlik ağıdır.
Bir SDK var mı?+
Henüz yok — cURL, Python ve JavaScript örnekleri dokümantasyonda mevcut.
Kurumsal planlar sunuyor musunuz?+
Evet — özel hacim, ihtiyaç halinde özel bir yanıt şeması ve talep üzerine tanıma motorunun tamamen çevrimdışı, şirket içi (on-premise) kurulumu. Yukarıdaki Kurumsal bölümüne bakın.

Entegre etmeye hazır mısınız?

Misafir kaydı otomasyonu mu arıyorsunuz? Misfora Otelcilik hakkında bilgi alın