Sözlük

Webhook — Bir şey olduğunda Veni'nin sizin adresinize gönderdiği otomatik bildirim. Sürekli "yeni bir şey var mı" diye sormanız gerekmez; olay olunca haber gelir.

Zarf (envelope) — Her olayın aynı dış kabı: {id, event, occurred_at, data}. Olaya özel alanlar data içindedir. Ayrıntı

CloudEvents — Olayların standart paketleme biçimi. Yaygın olduğu için hazır kütüphanelerle çalışır.

HMAC imza — İsteğin gerçekten Veni'den geldiğini ve yolda değişmediğini kanıtlayan damga. Paylaşılan gizli bir anahtarla hesaplanır; aynı hesabı siz de yapıp karşılaştırırsınız. Ayrıntı

Replay (tekrar oynatma) — Birinin daha önce gönderilmiş geçerli bir isteği kaydedip sonradan tekrar göndermesi. v2 imza zaman damgası taşıdığı için bunu ayıklayabilirsiniz; v1 taşımaz.

Idempotency (tekrar güvenliği) — Aynı işin iki kez istenmesi hâlinde bir kez yapılması. Gelen tarafta X-Veni-Delivery, giden tarafta Idempotency-Key ile sağlanır. Ayrıntı

Teslimat (delivery) — Tek bir olayın tek bir adrese gönderilme denemesi ve kaydı. Kendi kimliği vardır; yeniden denemelerde o kimlik değişmez.

Yeniden deneme profili — Bir adres cevap vermediğinde denemelerin hangi aralıklarla tekrarlanacağı. Restoran ve POS webhook'ları gecikmeye duyarlı, kısa takvimli profili kullanır.

DLQ (ulaşamayanlar listesi) — Deneme hakkı bitmiş teslimatların biriktiği liste. Olay kaybolmaz; oradan elle yeniden gönderilebilir.

Scope (yetki) — Bir anahtarın neye erişebileceğini sınırlayan izin. Örneğin menu:read olan bir anahtar menüyü okur ama yazamaz. Ayrıntı

Bearer anahtar — Authorization: Bearer <anahtar> başlığında taşınan gizli anahtar. Taşıyan herkes yetkilidir; bu yüzden sunucu tarafında saklanır.

IP allowlist — Partner anahtarının yalnız belirli IP adreslerinden ya da ağ aralıklarından (203.0.113.0/24) kullanılabilmesi. Anahtar sızsa bile başka bir yerden çalışmaz.

Hız sınırı (rate limit) — Belirli bir sürede yapabileceğiniz istek sayısı. Aşarsanız 429 alırsınız ve Retry-After kadar beklemeniz gerekir.

Gelen uç (inbound endpoint) — Sizin Veni'ye veri gönderdiğiniz, size özel açılan adres: POST /webhooks/in/{slug}. Ayrıntı

Konnektör — Veni'nin bir dış sistemle (POS, pazaryeri, e-fatura entegratörü, yemek kartı) kurduğu hazır bağlantı. Restoran kendi hesabını panelden bağlar. Katalog

POS-yönetimli menü — Menünün kaynağının POS entegrasyonu olduğu durum. Bu moda geçmeden tek ürün güncelleme uçları çalışmaz. Ayrıntı

Ham gövde (raw body) — İsteğin baytları, hiç ayrıştırılmamış hâli. İmza bunun üzerinden hesaplanır; JSON'u çözüp yeniden yazmak imzayı bozar.

Sır yenileme (rotation) — Webhook sırrını değiştirme. ⚠️ Restoran aboneliğinde geçiş penceresi yoktur: yeni sır anında yürürlüğe girer. Kesintisiz geçiş için doğrulayıcınız iki sırrı birden kabul etmelidir.