🚀 Hızlı Başlangıç¶
Bu sayfa, EnQualify SDK'yı ilk kez deneyen developerlar için hazırlanmıştır. Demo ortamına bağlanacak, örnek uygulamayı çalıştıracak ve ilk akışı ayağa kaldıracaksınız.
Adım 1 — Demo Uygulamayı İndir¶
iOS ve Android için ayrı demo uygulamalar mevcuttur. İkisini de indirebilir ya da çalıştığınız platforma göre birini seçebilirsiniz.
| Platform | İndirme |
|---|---|
| iOS | 🔴 Project Managerınızdan tedarik edebilirsiniz. |
| Android | 🔴 Project Managerınızdan tedarik edebilirsiniz. |
İndirdiğiniz zip'i açın. Klasör yapısı şöyle görünecektir:
iOS:
wide760EnQualifyDemo-iOS/ ├── EnQualifyDemo.xcodeproj ├── Podfile ├── EnQualifyDemo/ │ ├── AppDelegate.swift │ ├── ViewController.swift │ └── ...
Android:
wide760EnQualifyDemo-Android/ ├── app/ │ ├── src/ │ └── build.gradle ├── build.gradle └── ...
Adım 2 — Demo Ortamı Bilgileri¶
Aşağıdaki bilgiler EnQualify demo ortamına bağlanmak için hazır olarak sunulmaktadır. Herhangi bir kayıt veya hesap açma gerekmez.
| Alan | Değer |
|---|---|
| Ortam | Sandbox |
| API Key | Demo uygulamanın içinde otomatik tanımlıdır. Ama kendi uygulamanızı demo ortama baktırmak isterseniz bunun için Project Managerınızdan tedarik etmeniz gerekir. |
| Sunucu URL | https://enqualifymapip.enqura.com |
| SSL Sertifikası | Demo uygulamanın içinde otomatik tanımlıdır. Kendi uygulamanızı demo ortama baktırmak isterseniz, Project Managerınızdan tedarik etmeniz gerekir. |
💡 Demo ortamı OCR, NFC, Face ve VideoCall akışlarının tamamını destekler. Gerçek kimlik kartı ve cihaz kamerası gereklidir.
⚠️ Demo ortamı yalnızca test amaçlıdır. Gerçek kullanıcı verileriyle test yapılmaması önerilir.
Adım 3 — SSL Sertifikasını Projeye Ekle¶
Demo ortamına bağlanabilmek için SSL sertifikasının projeye eklenmesi gerekir.
iOS:
- İndirilen
.derdosyasını Xcode projesine sürükleyin - "Copy items if needed" seçeneğini işaretleyin
- Target'ınızın seçili olduğundan emin olun
Android:
- İndirilen
.derdosyasınıapp/src/main/assets/klasörüne kopyalayın
Sertifika kurulumu hakkında detaylı bilgi için ilgili sayfaya bakınız:
Adım 4 — Demo Bilgilerini Yapılandır¶
Demo uygulamasını açın ve aşağıdaki dosyada demo bilgilerini girin:
iOS — ViewController.swift:
wide760let baseModel = BaseModelOCR( url: "DEMO_URL", apiKey: "DEMO_API_KEY", sslCertificateName: "demo_certificate", // .der uzantısı olmadan sslCertificateExtension: "der" ) let sessionModel = SessionModelOCR( callType: "NewCustomer", reference: "demo-test-001", mobileUser: MobileUser( name: "Demo", surname: "User", mobilePhone: "5551234567", email: "[email protected]" ) )
Android — MainActivity.kt:
wide760val baseModel = BaseModelOCR( url = "DEMO_URL", apiKey = "DEMO_API_KEY", sslCertificateName = "demo_certificate", sslCertificateExtension = "der" ) val sessionModel = SessionModelOCR( callType = "NewCustomer", reference = "demo-test-001", mobileUser = MobileUser( name = "Demo", surname = "User", mobilePhone = "5551234567", email = "[email protected]" ) )
Adım 5 — Uygulamayı Çalıştır¶
iOS:
- Terminal'de
pod installçalıştırın .xcworkspacedosyasını açın (.xcodeprojdeğil)- Fiziksel cihaz seçin — NFC ve kamera simülatörde çalışmaz
Cmd + Rile çalıştırın
Android:
- Android Studio'da projeyi açın
Sync Project with Gradle Filesyapın- Fiziksel cihaz seçin
- Run butonuna basın
Adım 6 — İlk Akışı Dene¶
Uygulama açıldığında aşağıdaki akışları deneyebilirsiniz:
| Akış | Ne Test Eder? | Gereksinim |
|---|---|---|
| OCR | Kimlik kartı tarama, hologram kontrolü | Kimlik kartı + kamera |
| NFC | Çip okuma | NFC destekli cihaz + kimlik kartı |
| Face | Canlılık kontrolü, yüz karşılaştırma | Ön kamera |
| VideoCall | Temsilciyle görüşme | Kamera + mikrofon + internet |
💡 İlk denemede OCR → NFC → Face sırasını izlemenizi öneririz. Bu akış gerçek entegrasyonun en yaygın kullanım senaryosunu yansıtır.
Sonraki Adımlar¶
Demo çalıştı, sıra entegrasyona geldi:
- iOS entegrasyonuna başla → iOS SDK: İmplementasyon Rehberi
- Android entegrasyonuna başla → Android SDK: İmplementasyon Rehberi
- Ortam farkları hakkında bilgi al → Teknik Mimari & Servis Altyapısı
Takıldın mı?¶
Sık karşılaşılan ilk kurulum sorunları:
| Sorun | Çözüm |
|---|---|
iOS'ta pod install başarısız | SSH key ayarlanmamış olabilir → Başlarken → SSH Key Kurulumu |
| SSL hatası | Sertifika adı veya uzantısı hatalı girilmiş olabilir |
| NFC çalışmıyor | Cihazda NFC kapalı olabilir veya kart desteklenmiyor olabilir |
| VideoCall bağlanamıyor | Demo ortamında aktif temsilci olmayabilir, tekrar deneyin |
Sorun devam ediyorsa → 🔴 Project Managerınız ile iletişime geçebilirsiniz.