API ve entegrasyon
geliştiriciler için
Açık konuşalım: bugün herkese açık, self-servis bir API portalımız yok. API ve webhook altyapısı yol haritamızda — kurumsal projelerde kapsamı birlikte belirleyip talep üzerine açıyoruz. Bu sayfa, planladığımız yapıyı ve nasıl başvuracağınızı anlatır.
Durum: bu sayfadaki uç noktalar ve olaylar planlanan yapıyı gösterir. Hiçbiri “hazır, hemen kullanın” anlamına gelmez.
Kapsam
Ne tür entegrasyonlar mümkün?
Bugüne kadar en çok bu başlıklarda talep geldi. Projeniz listede yoksa da konuşabiliriz; olmayacaksa olmayacağını söyleriz.
Muhasebe ve ERP
Gün sonu satış, tahsilat ve belge verisinin kurumsal muhasebe ya da ERP tarafına aktarılması. Zincir işletmelerde en sık gelen talep budur.
Pazaryeri ve sipariş kanalları
Listemizde olmayan bir sipariş platformunun menü ve sipariş akışına bağlanması.
Otel / PMS
Restoran adisyonunun oda hesabına aktarılması, oda bazlı kapatma ve gün sonu mutabakatı.
Sadakat ve CRM
Puan kazanma-harcama, kupon doğrulama ve müşteri segmentlerinin dış CRM ile eşlenmesi.
BI ve raporlama
Ciro, ürün ve kanal verisinin kendi iş zekâsı aracınıza düzenli olarak akıtılması.
Markaya özel uygulama
Kendi mobil uygulamanızdan sipariş alma, menü çekme ve sipariş durumu gösterme.
Planlanan yapı
Uç noktalar ve olay bildirimleri
Aşağıdaki tablo, API açıldığında hedeflediğimiz yüzeyi gösterir. Yollar ve alan adları entegrasyon kapsamı belirlenirken değişebilir.
| Yöntem | Yol | Ne yapar | Yön |
|---|---|---|---|
| Menü ve katalog | |||
| GET | /v1/menu | Kategori, ürün, seçenek ve fiyat listesi | okuma |
| PATCH | /v1/menu/urun/{id} | Fiyat ve “tükendi” durumunu güncelleme | yazma |
| Sipariş ve adisyon | |||
| POST | /v1/siparis | Dış kanaldan sipariş oluşturma | yazma |
| GET | /v1/siparis/{id} | Sipariş ve durum bilgisini okuma | okuma |
| GET | /v1/adisyon | Açık adisyonlar ve masa durumları | okuma |
| POST | /v1/adisyon/{id}/kapat | Adisyonu ödeme bilgisiyle kapatma | yazma |
| Stok | |||
| GET | /v1/stok | Malzeme ve kalan miktar listesi | okuma |
| POST | /v1/stok/hareket | Giriş, çıkış ve sayım hareketi yazma | yazma |
| Rapor | |||
| GET | /v1/rapor/ciro | Tarih aralığı, şube ve kanal kırılımıyla ciro | okuma |
Tabloyu yana kaydırarak tamamını görebilirsiniz.
siparis.olusturuldu
Yeni sipariş oluştuğunda (kasa, QR menü ya da pazaryeri fark etmeksizin) tetiklenir.
siparis.durum_degisti
Sipariş hazırlanıyor → yolda → teslim edildi gibi durum geçişlerinde tetiklenir.
stok.tukendi
Bir ürün ya da malzeme tükendi işaretlendiğinde tetiklenir; kanalları kapatmak için kullanılır.
POST /v1/siparis — istek gövdesi
JSON{
"kanal": "mobil-uygulama",
"sube_id": "sb_0142",
"tip": "paket",
"musteri": {
"ad": "Deneme Müşteri",
"telefon": "+905XXXXXXXXX"
},
"kalemler": [
{
"urun_id": "urn_1001",
"adet": 2,
"secenekler": ["opt_acili"],
"not": "soğan olmasın"
},
{ "urun_id": "urn_2043", "adet": 1 }
],
"odeme": {
"tip": "online",
"durum": "tahsil_edildi",
"tutar": 640.00,
"para_birimi": "TRY"
}
}Webhook — siparis.olusturuldu
JSON{
"olay": "siparis.olusturuldu",
"olay_id": "evt_01J8K2QX",
"olusma_zamani": "2026-03-04T19:42:11+03:00",
"veri": {
"siparis_id": "sip_88214",
"sube_id": "sb_0142",
"kanal": "qr-menu",
"masa": "A7",
"toplam": 640.00,
"para_birimi": "TRY",
"durum": "alindi",
"kalem_sayisi": 3
}
}Webhook — stok.tukendi
JSON{
"olay": "stok.tukendi",
"olay_id": "evt_01J8K3RA",
"olusma_zamani": "2026-03-04T20:05:00+03:00",
"veri": {
"sube_id": "sb_0142",
"urun_id": "urn_2043",
"urun_ad": "Izgara Köfte",
"etki": "satisa_kapatildi",
"kanallar": ["qr-menu", "pazaryeri", "kasa"]
}
}Güvenlik yaklaşımı
Kimlik doğrulama ve sınırlar
Altyapı açıldığında izleyeceğimiz yaklaşım budur. Yazdığımız her madde “planlanan”dır; bugün kullanımda olduğunu iddia etmiyoruz.
API anahtarı
Her entegrasyon için ayrı anahtar planlanıyor. Anahtar; şube kapsamı ve okuma/yazma yetkisiyle sınırlandırılır, gerektiğinde tek tek iptal edilebilir.
İmzalı bildirim (callback)
Webhook gövdesi paylaşılan gizli anahtarla imzalanır (HMAC yaklaşımı). Alıcı taraf imzayı doğrulayarak bildirimin gerçekten bizden geldiğini teyit eder.
Oran sınırı (rate limit)
İstek sayısı anahtar bazında sınırlanır; sınır aşıldığında standart bir “çok fazla istek” yanıtı döner. Kesin sayılar entegrasyon açılırken sizinle birlikte belirlenir.
Yeniden deneme ve tekrar koruması
Başarısız bildirimlerin artan aralıklarla tekrarlanması planlanıyor. Her olay tekil bir olay kimliği taşır; aynı olayı iki kez işlememek için bu kimliği kullanırsınız.
Sayısal sınırlar (dakikadaki istek adedi, eşzamanlı bağlantı, saklama süresi) burada yazılmıyor; çünkü henüz sabitlenmiş değiller. Entegrasyon kapsamı belirlendiğinde bu değerler [ • • • ] proje bazında tanımlanır ve yazılı olarak paylaşılır.
Test ortamı
Gerçek veriye dokunmadan geliştirin
Kapsamı netleşen projelerde ayrı bir test ortamı açıyoruz. Örnek menü ve örnek siparişlerle çalışır; canlı işletmenin cirosunu, stoklarını ve müşteri verisini hiç etkilemez.
- Ayrı adres ve ayrı anahtar — canlı ortamla karışmaz
- Örnek menü, örnek şube ve test siparişleri hazır gelir
- Webhook bildirimlerini kendi adresinize yönlendirebilirsiniz
- Canlıya geçiş, test akışı birlikte doğrulandıktan sonra yapılır
Test ortamı otomatik açılmaz; talep üzerine ve proje bazında kurulur.
Başvuru
Entegrasyon başvurusu nasıl yapılır?
Talebinizi iletişim sayfasındaki formdan “Entegrasyon ve API” konusuyla iletin. Başvuruyu teknik ekip değerlendirir; yapılabilir değilse bunu da açıkça söyleriz.
Kapsamı anlatın
Hangi sistemi bağlamak istiyorsunuz, hangi veri hangi yöne akacak, ne sıklıkla? Birkaç cümle yeter.
Teknik değerlendirme
Mevcut altyapıyla nereye kadar gidebileceğimizi çıkarırız. Gereken uç nokta yoksa açıkça söyleriz.
Erişim ve test
Uygunsa test ortamı ve anahtar açılır, doküman paylaşılır; canlıya geçiş birlikte doğrulanır.
Yanıt süresi ve geliştirme takvimi için bu sayfada bir taahhüt vermiyoruz; her proje kapsamına göre ayrı değerlendirilir ve süre size yazılı olarak bildirilir.
Sık sorulanlar
Geliştiricilerin sorduğu
Bağlamak istediğiniz sistemi anlatın
Muhasebe, PMS, sadakat ya da kendi uygulamanız — kapsamı yazın, teknik ekip nereye kadar gidebileceğimizi açıkça söylesin.
Kredi kartı gerekmez · Kurulum ve eğitim dahil · Taahhütsüz başlangıç