SDKs
Kimlik doğrulama SDK'sı ve SDK'sız yol.
Çoğu entegrasyonun hiç SDK'ya ihtiyacı yoktur; işi barındırılan sayfa yapar. Akışın kendi sayfanızın içinde kalmasını istediğinizde web widget'ı devreye girer. Yerel mobil SDK'lar sırada.
SDK'sız yol
Barındırılan sayfa, hiçbir platformda SDK gerektirmez.
POST /v1/sessions bir verification_url döndürür. Bunu, ürününüzün bağlantı göndermek için zaten kullandığı yöntemle (e-posta, SMS, uygulama içi yönlendirme, ekranda bir QR kod) başvuru sahibine iletin; ShieldID, görüntü yakalamayı, canlılık testini ve selfie'yi başvuru sahibinin kendi telefonunda yönetir.
- Bir web uygulamasından, yerel bir uygulamanın sistem tarayıcısından veya WebView'ından, bir e-posta bağlantısından ya da bir kiosk QR kodundan çalışır; kurulacak hiçbir şey yoktur
- Uygun planlarda beyaz etiket markalama; böylece bir üçüncü tarafa yönlendirme gibi görünmez
- Sonuçlar size return_url yönlendirmesi ve imzalı webhook aracılığıyla ulaşır; istemci tarafında geri çağrı bağlantısı kurmanız gerekmez
Web widget'ı
Akışı kendi sayfanıza gömün.
Barındırılan doğrulama akışını, başvuru sahibini sayfanızdan uzaklaştırmak yerine sayfanızdaki bir iframe içinde görüntüleyen küçük bir betik.
Bugün neler çalışıyor
- TLVerify.init({ apiKey, containerId, returnUrl, cancelUrl, webhookUrl, locale, theme }) bir oturum oluşturur ve seçtiğiniz bir öğenin içine yerleştirir
- Barındırılan sayfayla aynı yakalama akışını, accentColor ve logonuzla birlikte kendi düzeninizin içinde çalıştırır
- Bugün oturum oluşturma ve akışı sayfa içinde gösterme için çalışır
Tamamlanma geri çağrıları
YakındaonComplete, onCancel, onStep ve otomatik iframe yeniden boyutlandırma widget'ın arayüzünün bir parçasıdır, ancak akış içinde henüz hiçbir şey bunları tetiklememektedir. Bunların çalışmasına bağlı mantık oluşturmayın; bunun yerine bugün çalışan dönüş URL'sini ve webhook'u kullanın.
Tarayıcıda API anahtarları hakkında bir not
Widget'ın kendi init() çağrısının, istemci tarafı JavaScript'te ham bir apiKey kabul ettiği belgelenmiştir. Üretimde bunu önermiyoruz: kaynağı görüntüleyen herkes anahtarınıza ulaşır. Bunun yerine oturumu arka uç sisteminizde POST /v1/sessions ile oluşturun ve widget'a görüntülenmek üzere ortaya çıkan verification_url değerini iletin. Bu, barındırılan akışla aynı öneridir; yalnızca bağlantı olarak vermek yerine sayfaya gömülür.
<div id="shieldid-verify"></div>
<!-- Exact script URL is published with your API keys; the path below is illustrative. -->
<script src="https://cdn.shieldid.ca/sdk/v1/widget.js"></script>
<script>
// Recommended: create the session on your backend first (see API reference),
// then pass its verification_url straight through — never a raw API key.
TLVerify.init({
containerId: "shieldid-verify",
verificationUrl: "{{ session.verification_url }}", // from your backend
theme: { accentColor: "#0B5CD8" },
});
</script>Mobil
Yerel SDK'lar yakında geliyor.
Bugün için iOS veya Android SDK'sı yoktur. Gelene kadar, barındırılan doğrulama sayfasını uygulamanızın sistem tarayıcısında veya bir WebView içinde açın. Bu, web başvuru sahibinin gördüğü akışın aynısıdır ve uygulamanızın çalıştığı her platformda şimdiden çalışır.
YakındaYerel iOS ve Android SDK'ları
Bir yol seçmek
Üç giriş yolu, dürüstçe karşılaştırıldı.
Gömmek için özel bir nedeniniz yoksa barındırılan sayfayla başlayın.
| Yetenek | Barındırılan sayfa | Web widget'ı | Mobil SDK |
|---|---|---|---|
| SDK yok, istemci tarafı kod yok | Evet | Hayır | Yakında |
| Kendi sayfanızın içinde kalır | Bağlantı olarak açılır | Gömülü iframe | Yakında |
| Kodunuzda tamamlanma geri çağrıları | Dönüş URL'si + webhook | Yakında | Yakında |
| Sizin markanız | Uygun planlarda | Uygun planlarda | Yakında |
| Bugün çalışıyor | Evet | Evet | Hayır |
Sorular
SDK ve widget SSS.
Geliştirmeye başlayın
Barındırılan sayfa, başlamanın en hızlı yoludur.
Bir API çağrısı, bir bağlantı, SDK gerekmez. Bugün bir sandbox anahtarıyla deneyin.