Teslimat günlüğü

Webhook'larınız beklediğiniz gibi gelmiyorsa, "Veni tarafında ne görünüyor" sorusunun cevabını süreli bir bağlantıyla veriyoruz. Platformda hesabınız olması gerekmez.

Nasıl alınır

Bize teknik muhatap adresinizden yazın. Firmanıza bir bağlantı üretilir ve size iletilir:

https://api.veni.com.tr/api/v1/integrator-log?token=<jeton>

Bağlantı JSON döndürür; tarayıcıda da açılır.

Bağlantı bir kez verilir

Jetonun kendisi saklanmaz, yalnız kriptografik özeti. Bağlantıyı kaybederseniz kurtarılamaz; yenisi üretilir. Paylaşmayın: elinde bağlantı olan herkes aynı günlüğü okuyabilir.

Süre ve iptal

• Bağlantının bir son kullanma tarihi var (tipik 14 gün, en çok 90).
• Gerektiğinde iptal edilebilir.
• Geçersiz, süresi dolmuş ve iptal edilmiş jeton aynı yanıtı alır: 404. Hangisi olduğu söylenmez.

Süre dolduğunda ya da yeni bir bağlantı gerektiğinde yine bize yazın.

Ne döner

Teslimatın üst verisi: hangi olay, hangi aboneliğe, kaç denemede, sizin ucunuzun döndürdüğü HTTP kodu ve hata metni, zaman damgaları.

Alan	Anlamı
event_type	Olay adı (order.accepted …)
status	pending · delivered · failed · exhausted
attempt_count	Kaçıncı deneme
last_response_code	Sizin ucunuzun döndürdüğü HTTP kodu
last_error	Teslimatın neden olmadığı
subscription_url	Hangi adrese gönderildiği
restaurant_name	Hangi restoranın olayı
created_at · delivered_at · next_retry_at	Zaman damgaları

failed kalıcı değildir

failed "bu deneme olmadı, yeniden denenecek" demek. Kalıcı olan exhausted: deneme hakkı tükendi ve olay ulaşamayanlar listesine düştü. İkisini aynı kefeye koyarsanız, sonunda teslim edilmiş olayları kayıp sanırsınız.

Sipariş içeriği bu günlükte YOK

payload dönmez — teslimat adresi ve müşteri telefonu gibi kişisel veriler bu bağlantıda bulunmaz. O içeriği teslimat anında siz aldınız.

Sorgu parametreleri

Parametre	Varsayılan	Not
limit	100	En çok 100 satır
offset	0	Sayfalama
status	—	Tek duruma süzer (ör. exhausted)

En yeni teslimat en üstte döner.

Bu bağlantının yapmadıkları

• Anahtar üretmez, döndürmez. POS anahtarını ve webhook sırrını restoran kendi panelinden yönetir.
• Ayar değiştirmez. Yalnız okur.
• Canlı/test ayrımı yapmaz. Firmanızın tüm aboneliklerinin teslimatlarını bir arada gösterir.