Ana içeriğe geç
Mevzuat RadarDokümantasyon
Uygulamaya git ↗

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:

İşlemTaslaktaki davranış
İstekPOST /webhooks/mevzuatradar yolunda gövdeyi UTF-8 metin olarak okur
İmzaX-Webhook-Signature ile eski, yalnız gövdeye dayalı HMAC SHA-256 imzasını karşılaştırır
SırMEVZUATRADAR_WEBHOOK_SECRET ortam değişkenini okur; yoksa sabit örnek sır kullanır
Geçersiz istekBoş tekilleştirme anahtarı veya geçersiz imza için 401 döner
TekilleştirmeAnahtarı bellekte bir HashSet içinde tutar; tekrar teslimata 202 döner
İlk kabulAnahtarı 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:

  1. HTTPS alıcısı ham gövdenin özgün baytları üzerinde X-Webhook-Signature-V2 imzasını ve 300 saniyelik zaman toleransını denetler. Sır, kurumun güvenli sır yönetimi üzerinden sağlanır.
  2. 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.
  3. İşleyici gerekli veriyi https://api.mevzuatradar.com üzerinden ilgili API izin kapsamıyla okur.
  4. 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.
  5. X-Webhook-Idempotency-Key hedef 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 imza401; olay işlenmez
Daha önce kalıcı kabul edilmiş anahtar202; ikinci Logo kaydı oluşturulmaz
Kalıcı kuyruğa kayıt başarısız503; kabul edildiği bildirilmez
Kalıcı kuyruk kabul etti202; 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.