Support Hub/API & Integrations/ngrok ile Cams Geri Çağırma URL'lerinin Yerel Olarak Test…
Translated from the English article and reviewed by a person. Read the English original
Developer

ngrok ile Cams Geri Çağırma URL'lerinin Yerel Olarak Test Edilmesi

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

  1. https://ngrok.com adresini ziyaret edin
  2. İşletim sisteminize uygun sürümü indirin.
  3. Çalıştırılabilir dosyayı çıkarın ve kurun.
  4. Ücretsiz bir hesap oluşturun (isteğe bağlı ancak önerilir).
  5. AuthToken oluşturun.
  6. 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.

  1. Aracı aşağıdaki bağlantıyı kullanarak indirip çıkarın ve kurun.
    https://developer.camsbiometrics.com/setup/ngrok-helper-kit.rar
  2. app.properties dosyasını düzenleyin.
  3. Yapılandırın:
    ngrok.auth.token=
    ngrok.tunnel.url=
  4. Ç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.

Was this article helpful?