İçeriğe geç
cibusyGeliştiriciler
TREN
API anahtarı al
Cibusy API

Menünüz kendi sitenizde,
siparişler mutfağınızda

Web siteniz veya uygulamanız Cibusy menünüzü okur, siparişi doğrudan Cibusy POS'a ve mutfağa, rezervasyonu mekanın rezervasyon listesine gönderir; ikisinin de durumunu webhook ile öğrenir.

BaşlarkenAPI referansı
REST ve JSONİmzalı webhook'larÖdeme mekanda
Sipariş gönder
POST /public/v1/venues/{venueId}/orders
X-Api-Key: cbk_••••••••
Idempotency-Key: web-order-2041

{
  "type": "Takeaway",
  "customer": { "name": "Ayşe", "phone": "+905550000000" },
  "paymentMethod": "Card",
  "lines": [{
    "productId": "5d2c8a41…",
    "portionId": "a8e1f6c3…",
    "quantity": 2
  }]
}

HTTP/1.1 201 Created
{
  "success": true,
  "data": {
    "order": { "number": 57, "status": "Received", … }
  }
}
Dokümantasyon

Nereden başlamalı?

Rehberler sizi ilk istekten webhook doğrulamaya kadar adım adım götürür; API referansı her uç noktayı alanları ve örnekleriyle anlatır.

Ne işe yarar?

Cibusy'deki mekanınız,
kendi sitenizde çalışır

Menünüzü Cibusy'de bir kez düzenlersiniz; siteniz ve uygulamanız aynı menüyü gösterir, siparişler aynı mutfağa düşer.

Menünüz sitenizde

Kategoriler, porsiyonlar, ekstralar, alerjenler ve stok durumu. Cibusy'de yaptığınız değişiklik API'de hemen görünür.

Siparişler doğrudan mutfağa

Masaya, gel-al ya da paket sipariş Cibusy POS'a düşer ve mutfak fişi o an yazdırılır. Araya onay adımı girmez; istek tekrarlansa da sipariş mutfağa iki kez düşmez.

Rezervasyonlar mekanın listesine

Sitenizin aldığı rezervasyon, mekanın diğer rezervasyonlarıyla aynı listeye düşer. Saatleri mekanın kendi takviminden alırsınız; misafire haberi siteniz verir.

Durum webhook ile

Sipariş hazırlanırken, hazır olduğunda ya da kapandığında; rezervasyon onaylandığında ya da iptal edildiğinde sunucunuza imzalı bir bildirim gelir. Sürekli sorgulamanız gerekmez.

Fiyatı Cibusy hesaplar

Sepeti göndermeden önce fiyatlandırın. Kampanyalarınız ve hizmet bedeli kasadaki siparişte olduğu gibi uygulanır.

Şubeler tek anahtarla

Merkez hesabın anahtarı tüm şubelere ulaşır; bir şubenin anahtarı ise yalnız o şubeye.

Başlarken

Üç adımda ilk istek

Anahtarı mekan hesabınızla panelden oluşturursunuz; çalışan hesapları anahtar oluşturamaz.

1

Panele girin

Mekan hesabınızla Cibusy paneline giriş yapın ve Mekan Ayarları altındaki API Anahtarları sayfasını açın.

2

Anahtar oluşturun

Entegrasyona bir ad verin, sipariş ve rezervasyon izinlerini ve webhook adresini seçin. Anahtar yalnız bir kez gösterilir; hemen kopyalayın.

3

Sunucunuzdan çağırın

Anahtarı X-Api-Key başlığında gönderin. Anahtar yalnız sunucuda kullanılır; tarayıcıdan yapılan çağrılar kabul edilmez.

Bilmeniz gerekenler

Sınırlar ve kurallar

Ödeme mekanda alınır

API üzerinden ödeme alınmaz; müşteri siparişini mekanda öder. Hatalı bir sipariş de kasadan iptal edilir.

Hız sınırları

Anahtar başına dakikada yaklaşık 120 okuma ve 30 sipariş ya da rezervasyon isteği. Menüyü sunucunuzda saklayıp ETag ile yenileyin.

Sipariş ve rezervasyon için abonelik

Aboneliği sona eren mekanın anahtarı menüyü okumaya devam eder; sipariş ya da rezervasyon göndermek için abonelik gerekir.

Anahtarınızı oluşturun,
ilk isteği gönderin

API anahtarını mekan hesabınızla Cibusy panelinde birkaç saniyede oluşturursunuz. Anahtar yalnız bir kez gösterilir; hemen kopyalayın.

API anahtarı alBaşlarken