Logo Tiger
Durum: müşteri tarafından geliştirilmesi planlanan bağlantı. Mevcut kod hazır Logo Tiger bağlayıcısı içermez. C# örneği webhook alımını gösterir; Logo’ya görev, belge veya onay kaydı yazmaz ve Logo’ya özgü dışa aktarma dosyası üretmez.
C# Alıcı Taslağı
apps/docs/examples/logo-webhook-handler.cs, ASP.NET Core minimal API
taslağıdır. Mevcut davranışı şöyledir:
| İşlem | Taslaktaki davranış |
|---|---|
| İstek | POST /webhooks/mevzuatradar yolunda gövdeyi UTF-8 metin olarak okur |
| İmza | X-Webhook-Signature ile eski, yalnız gövdeye dayalı HMAC SHA-256 imzasını karşılaştırır |
| Sır | MEVZUATRADAR_WEBHOOK_SECRET ortam değişkenini okur; yoksa sabit örnek sır kullanır |
| Geçersiz istek | Boş tekilleştirme anahtarı veya geçersiz imza için 401 döner |
| Tekilleştirme | Anahtarı bellekte bir HashSet içinde tutar; tekrar teslimata 202 döner |
| İlk kabul | Anahtarı belleğe ekler ve 202 döner; kuyruk kaydı veya Logo işlemi yapmaz |
Bellekteki anahtarlar süreç yeniden başladığında kaybolur. Taslakta V2 zaman
damgası kontrolü, JSON şema doğrulaması, kalıcı kuyruk ve eşzamanlı istekler
için atomik tekilleştirme bulunmaz. Sabit örnek sır üretimde kullanılamaz.
Taslağın 202 yanıtı, Logo’da iş oluşturulduğu veya kalıcı kuyruğa kayıt
yapıldığı anlamına gelmez.
Planlanan Aktarım
Aşağıdaki adımlar mevcut taslağın işlevleri değil, müşteri uygulamasında tamamlanacak tasarımdır:
- HTTPS alıcısı ham gövdenin özgün baytları üzerinde
X-Webhook-Signature-V2imzasını ve 300 saniyelik zaman toleransını denetler. Sır, kurumun güvenli sır yönetimi üzerinden sağlanır. - Olay türü, sürümü ve gövdesi doğrulanır. Tekilleştirme anahtarı ile iş kaydı kalıcı depoya atomik olarak yazılır.
- İşleyici gerekli veriyi
https://api.mevzuatradar.comüzerinden ilgili API izin kapsamıyla okur. - Logo sürümü, lisansı ve kurumun kullanacağı arayüz doğrulandıktan sonra hedef kayıt türü ile alan eşlemesi belirlenir ve yazma işlemi geliştirilir.
X-Webhook-Idempotency-Keyhedef sistemde izlenebilir bir dış referansla eşleştirilir. Bu eşleme, kalıcı benzersizlik kontrolü ve işlem kaydıyla birlikte tekrar kayıt oluşumunu önleyecek şekilde uygulanır.
Yanıt ve Yeniden Deneme
| Durum | Üretim alıcısı için önerilen yanıt |
|---|---|
| Geçersiz imza | 401; olay işlenmez |
| Daha önce kalıcı kabul edilmiş anahtar | 202; ikinci Logo kaydı oluşturulmaz |
| Kalıcı kuyruğa kayıt başarısız | 503; kabul edildiği bildirilmez |
| Kalıcı kuyruk kabul etti | 202; Logo işlemi arka planda sürer |
MevzuatRadar, 4xx dahil başarısız HTTP yanıtlarını deneme sınırına kadar
yeniden deneyebilir. Taslakta 503 üreten bir Logo bağlantısı yoktur.
Üretim alıcısı 2xx döndükten sonra Logo’da oluşan hata kurumun kuyruğunda
ele alınır; MevzuatRadar’dan bu hata için yeni teslimat beklenmez.
Ortak alıcı sözleşmesi ve Webhook Akışı, imza başlıkları ile teslimat davranışının ayrıntılarını açıklar.