Ağrı Merkez'de webhook servisi yaptırmak

01Webhook servisi ile neler yapılır?

Her işletmenin ihtiyacı farklıdır; yine de çoğu webhook servisi projesinde şu başlıklar konuşulur:

• imza doğrulama
• yeniden deneme
• log

İhtiyaca göre API yönetim paneli ve geliştirici portalı, kimlik doğrulama ve SSO ve özel API servisi da aynı yol haritasına eklenebilir.

02Hangi durumlarda webhook servisi yaptırılır?

Log gerektiğinde

Log, webhook servisi projesinde kapsamın başında konuşulan başlıklardandır; analizde kimin kullanacağı ve nasıl çalışacağı netleştirilir.

Geliştiriciler API'yi anlamakta zorlandığında

OpenAPI şeması, örnek istekler ve kılavuzla öğrenme süresi kısalır.

Olaylar anlık bildirilmesi gerektiğinde

Webhook altyapısı imza doğrulama ve yeniden deneme ile kurulur.

03Webhook servisi planlarken bilinmesi gerekenler

• webhook imza doğrulaması
• sürümleme stratejisi
• hata kodu standardı.

04Sık karşılaşılan durumlar

05Ağrı Merkez'de webhook servisi: çalışma düzeni

Ağrı Merkez'in PTT verisindeki 147 yerleşim kaydı 3 farklı posta koduna dağılır. Bu kayıtlardan 1 tanesi organize sanayi veya serbest bölge kaydıdır.

Ağrı Merkez'de bulunan bir işletmeyle çalışırken toplantılar görüntülü yapılır, her aşama test ortamında paylaşılır ve geri bildirimler ortak panoda toplanır; yerinde bulunmak gereken kurulum ve eğitim adımları ayrıca planlanır.

Aynı ildeki Hamur, Tutak ve Patnos ilçeleri için de webhook servisi talepleri değerlendirilir; toplantılar uzaktan yapılır.

06Çalışma adımları

1. İlk görüşme: Kısa bir görüşmede ne yapmak istediğinizi, bugün nasıl çalıştığınızı ve öncelikli sorunu konuşuruz.
2. Analiz: Ekranlar, raporlar ve entegrasyonlar için gerçek örnekler üzerinden ihtiyaç listesi çıkarılır.
3. Kapsam ve yazılı teklif: Modüller, aşamalar ve teslim kriterleri yazılı bir kapsamla belirlenir; teklif bu kapsama göre verilir.
4. Tasarım ve prototip: Temel ekranlar çizilir; kullanıcıların geri bildirimiyle akış sadeleştirilir.
5. Geliştirme ve test: Kod sürüm kontrolüyle yönetilir, kritik akışlar otomatik testlerle korunur.
6. Yayın, veri aktarımı ve eğitim: Mevcut veriler aktarılır, sistem yayına alınır ve kullanıcılara eğitim verilir.
7. Bakım ve destek: Hata bildirimleri kayıt altına alınır, güncellemeler test edilerek uygulanır.

07Rakamlarla örnek bir senaryo

08Nasıl çalışıyoruz?

Tasarım, geliştirme, test ve yayın adımları aynı ekip içinde yürür. Kod Git ile sürümlenir, kritik akışlar Playwright testleriyle korunur, yayın Docker konteynerleriyle tekrarlanabilir biçimde yapılır.

• Kapsam ve teslim kriterleri yazılı olur.
• Kaynak kod ve veri işletmeye teslim edilir.
• Ölçülebilir hedefler konur: arama ve WhatsApp tıklaması, form talebi, işlem süresi.

Türkiye'nin 81 ilindeki işletmelerle uzaktan çalışıyoruz: görüntülü toplantı, ekran paylaşımlı demo ve ortak proje panosu. Donanım kurulumu, depo barkod sistemi kurulumu, saha keşfi veya kullanıcı eğitimi gereken işlerde yerinde çalışma planlanır.

09Uzman desteği ne zaman şart olur?

Webhook servisi işlerinde bazı durumlar plansız ilerlerse sonradan pahalıya mal olur:

• Webhook bildirimleri kayboluyor: yeniden deneme ve teslim kaydı yok.
• İş ortakları API'yi yanlış kullanıyor: dokümantasyon eksik veya güncel değil.
• Kişisel veya finansal verinin işlendiği akışlar
• Birden fazla sistemle entegrasyon gerektiren işler

SSSSık sorulan sorular

→İlgili sayfalar

Bu sayfada geçen kavramlar

• imza doğrulama
• yeniden deneme
• log
• Swagger
• OpenAPI
• webhook
• SSO
• geliştirici portalı
• OAuth 2.0
• Ağrı
• Merkez