ngrok ile Cams Geri Çağırma URL'lerinin Yerel Olarak Test Edilmesi
Entegrasyonunuzu üretim ortamına göndermeden önce, bir tünelleme aracı kullanarak Cams API geri çağırmalarını doğrudan geliştirme makinenizde test edebilirsiniz. Bu kılavuz, adım adım kurulum sürecinde size rehberlik eder.
Bir tünele neden ihtiyacınız var
Geri çağırma ve webhook istekleri, internet üzerinden Cams platformundan gönderilir. Makinenizde çalışan yerel bir uygulama, bir güvenlik duvarı veya NAT ağı arkasında olduğu için bu istekleri doğrudan alamaz.
Bir tünelleme hizmeti, gelen istekleri yerel uygulamanıza yönlendiren güvenli bir genel uç nokta oluşturur.
Avantajlar
- Geri çağırmaları dağıtımdan önce test edin
- Webhook yüklerini gerçek zamanlı olarak hata ayıklayın
- İstek işlemeyi yerel olarak doğrulayın
- Geliştirme ve dağıtım süresini azaltın
Önerilen Tünelleme Araçları

ngrok kurulumu (önerilir)
Kurulum
- https://ngrok.com adresini ziyaret edin
- İşletim sisteminize uygun sürümü indirin.
- Çalıştırılabilir dosyayı çıkarın ve kurun.
- Ücretsiz bir hesap oluşturun (isteğe bağlı ancak önerilir).
- AuthToken oluşturun.
- AuthToken'ınızı yapılandırın.
ngrok config add-authtoken YOUR_AUTHTOKEN
Tünel başlatma
ngrok zaten yapılandırılmışsa:
ngrok http 3000
3000 yerine uygulamanızın bağlantı noktasını yazın.
Örnek çıktı
Forwarding https://abc123.ngrok-free.app -> http://localhost:3000
Uygulamanıza artık genel HTTPS URL'si üzerinden erişilebilir.
Alternatif: Cams Geri Çağırma Test Aracını Kullanın
Cams tarafından sağlanan geri çağırma test yardımcı programını da kullanabilirsiniz.
- Aracı aşağıdaki bağlantıyı kullanarak indirip çıkarın ve kurun.
https://developer.camsbiometrics.com/setup/ngrok-helper-kit.rar app.propertiesdosyasını düzenleyin.- Yapılandırın:
ngrok.auth.token=
ngrok.tunnel.url= - Çalıştırın:
check_ngrok.bat
Yardımcı program tüneli otomatik olarak oluşturur ve yerel geri çağırma testini kolaylaştırır.
Geri Çağırma Entegrasyonu Kurulumu
Adım 1: Yerel uygulamanızı başlatın
Adım 2: Tüneli başlatın
Adım 3: Geri çağırmayı test edin
Örnek bir test olayı tetikleyin ve aşağıdakileri doğrulayın:
- Uygulamanız geri çağırma isteğini alır.
- İstek yükleri başarıyla işlenir.
- Uygulama günlüklerinde hata görünmez.
- İstekler tünel panelinde görülebilir.
En iyi uygulamalar
- Mümkün olduğunda HTTPS geri çağırma URL'leri kullanın.
- Test sırasında tüneli etkin tutun.
- İstek doğrulaması için uygulama günlüklerini inceleyin.
- Uç noktanızın beklenen HTTP yanıt kodlarını döndürdüğünü doğrulayın.
- Üretime geçmeden önce hata yönetimi senaryolarını test edin.
Önemli notlar
- Ücretsiz ngrok URL'leri, tünel her yeniden başlatıldığında değişir.
- Ücretli ngrok planları, ayrılmış alan adlarını ve özel alt alan adlarını destekler.
- Geçici tüneller yalnızca geliştirme ve test amaçlarıyla kullanılmalıdır.
Sonuç
Yerel sunucunuzu bir tünelleme hizmeti üzerinden açmak, uygulamanızı dağıtmadan önce geri çağırma URL'nizi test etmenin en hızlı yoludur. ngrok, Cloudflare Tunnel veya localhost.run kullanmanız fark etmez; bu süreç, gerçek zamanlı geri çağırma isteklerini almanıza ve entegrasyonunuzu yerel bir geliştirme ortamında doğrulamanıza olanak tanır.
Yukarıdaki adımları izlemek, geliştirmeden üretim dağıtımına sorunsuz bir geçiş sağlamaya yardımcı olacaktır.