Görünüm
Erişim modeli
Veni'nin üç geliştirici yüzeyi var ve kapıları farklı. Hangisine ihtiyacınız olduğu, nasıl başvuracağınızı belirler.
| Restoran webhook'u | POS API | Partner API | |
|---|---|---|---|
| Anahtarı kim açar | Restoran panelden, entegratör olarak sizi seçer | Restoran panelden, entegratör olarak sizi seçer | Veni, anlaşma sonrası |
| Kimlik | Restoran oturum anahtarı (JWT) | POS anahtarı (vnrs_live_…) | Partner anahtarı (vnps_live_…) |
| Önkoşul | Başvuru + anlaşma | Başvuru + anlaşma | Başvuru + anlaşma |
| Ne yapar | Sipariş durumu değişince haber verir | Menü yazar, sipariş okur, durum günceller | Kurye/teslimat açar, sorgular, iptal eder |
| Kapsam | Tek restoran | Tek restoran | Anlaşmada tanımlı |
| IP kısıtı | Yok | Anahtar bazında açılabilir | Var (allowlist) |
| Adres kısıtı | Var — entegratörün bildirdiği alan adları | Yok (çağrıyı siz yaparsınız) | Yok |
Restoran açar, entegratöre bağlar
Anahtarı ve webhook'u restoran kendi panelinden üretir. Üretim sırasında anahtarın kime verileceği seçilir ve o listede yalnız Veni ile anlaşması aktif POS entegratörleri çıkar. Kendi yazılımını bağlamak isteyen işletme de entegratör olarak başvurur; istisna yoktur.
Anlaşma sonrası müşteriniz olan restoran iki şeyi kendi panelinden açar:
- Webhook — panelden ya da yönetim uçlarından. Burada da entegratör seçilir. Dört sipariş olayına abone olunabilir.
- POS anahtarı — restoran panelinde Ayarlar → Entegrasyon (POS/API). Anahtar
vnrs_live_ile başlar ve düz metni yalnız oluşturma yanıtında görünür. Ön eki koda sabitlemeyin; kimlik doğrulama ön eke değil anahtarın kendisine bakar.
POS anahtarının iki rolü var ve rol yetkiyi belirler:
| Rol | Ne yapabilir |
|---|---|
read_mirror | Menüyü ve siparişleri okur, sipariş durumunu günceller |
pos_push | Yukarıdakiler + menü ve stok yazar |
Bir restoranda en çok 10 aktif anahtar olabilir. Anahtarı iptal etmek anında etki eder.
Anlaşma kapanırsa anahtar ölür
Bir entegratörün anlaşması sona ererse o entegratöre verilmiş bütün anahtarlar bir sonraki istekte 401 döner ve aynı entegratöre bağlı webhook'lar bir sonraki teslimatta durur. Ayrı bir iptal adımı yoktur; kapı her istekte kontrol edilir.
Kendi sisteminiz bir POS ise
Menüyü Veni'ye siz yazar, siparişleri siz çeker, durumu siz ilerletirsiniz. Restoranın panele girmesi gerekmez; yalnız anahtarı üretip size verir.
Partner erişimi anlaşmayla açılır
Pazaryeri, agregatör, ERP ya da kendi müşterisi adına kurye çağıran bir sistem yazıyorsanız Partner API gerekir. Self-servis kayıt yoktur; anahtarı Veni üretir.
Dört adım:
- Başvuru. veni.com.tr/iletisim → konu Partner / API başvurusu. Ne yapmak istediğinizi ve hangi uçlara ihtiyacınız olduğunu yazın.
- Anlaşma. Ticari koşullar ve veri işleme sorumlulukları yazılı hâle gelir.
- Anahtar ve kısıtlar. Partner anahtarı, çağrı yapacağınız IP adresleri ve dakika başına istek sınırı birlikte ayarlanır. Tekil adres (
203.0.113.10) ya da ağ aralığı (203.0.113.0/24) bildirebilirsiniz; bulutta çalışıyorsanız çıkış bloğunu aralık olarak vermek en pratiğidir. Allowlist dışından gelen istek reddedilir. - Canlıya alma. Sözleşme tarafını test ortamında bitirir, para tarafını canlı anahtarla küçük tutarlarla doğrularsınız — Canlıya geçiş.
Hangisi bana lazım
- Restoranın siparişini kendi ekranında göstermek → webhook; yazılımı yazan firma entegratör olarak anlaşır.
- POS/adisyon yazılımı, menüyü siz yöneteceksiniz → POS API; önce entegratör anlaşması, sonra restoranın ürettiği anahtar.
- Kendi müşterinize Veni kuryesi çağırmak → Partner API, başvuru gerekir.
- Raporlama ya da muhasebe verisi çekmek → ayrı bir veri API'si yok. Siparişi POS API ile okur, değişiklikleri webhook ile alırsınız; ikisi de restoranın kendi verisiyle sınırlıdır.