Araban'da webhook servisi yaptırmak

01Webhook servisi nedir, kimler için uygun?

Webhook servisi projelerinde ihtiyaca göre şu özellikler bir araya getirilir:

• 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?

Olaylar anlık bildirilmesi gerektiğinde

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

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

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

Entegrasyon talepleri tek tek karşılandığında

Standart bir API ve dokümantasyon, her iş ortağı için ayrı geliştirme yapma ihtiyacını azaltır.

03Webhook servisi planlarken bilinmesi gerekenler

• hata kodu standardı.
• webhook imza doğrulaması
• kimlik doğrulama (API anahtarı, OAuth 2.0)

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

05Araban'da webhook servisi: çalışma düzeni

Araban'ın PTT verisindeki 49 yerleşim kaydı 1 farklı posta koduna dağılır. Büyükşehirlerde merkez ve şube yapısıyla çalışan işletmeler için webhook servisi tasarımında merkez-şube yetki yapısı ve birleşik raporlama öne çıkar.

Araban'da 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.

Gaziantep genelinde Nizip, Karkamış ve Şehitkamil gibi diğer ilçelerdeki işletmelerle de aynı uzaktan çalışma düzeniyle ilerlenir.

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: Hangi işin hangi aşamada teslim edileceği ve neyin kapsam dışı olduğu teklifte açıkça yazılır.
4. Tasarım ve prototip: Tıklanabilir bir prototiple kullanıcı yolculuğu baştan sona denenir.
5. Geliştirme ve test: Geliştirme aşamalı ilerler; her aşama test ortamında denenip onaylanır.
6. Yayın, veri aktarımı ve eğitim: Veri aktarımı doğrulandıktan sonra yayına geçilir; ekip için kısa kullanım kılavuzu hazırlanır.
7. Bakım ve destek: Hata bildirimleri kayıt altına alınır, güncellemeler test edilerek uygulanır.

07Örnek kapsam hesabı

08Çalışma düzenimiz

Çalışma düzenimizde sürüm kontrolü, otomatik testler, konteyner tabanlı yayın ve izleme araçları standarttır; her değişiklik bu adımlardan geçerek canlıya çıkar.

• Her değişiklik önce test ortamında denenir.
• Yayın sonrası bakım ve destek planlanır.
• Kaynak kod ve veri işletmeye teslim edilir.

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:

• Eski sürümü kullananlar bozuluyor: sürümleme ve geçiş takvimi yok.
• Webhook bildirimleri kayboluyor: yeniden deneme ve teslim kaydı yok.
• 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
• API anahtarı
• SSO
• OAuth 2.0
• Gaziantep
• Araban