Geliştirici / Entegrasyon

HummyTummy’yi kendi sistemlerinize bağlayın: kendi ekranlarınızı/uygulamalarınızı çalıştırın, sipariş ve ödeme olaylarını sunucunuza akıtın, REST API üzerinden restoran verisine erişin. Tüm uçlar tek bir API tabanı altında toplanır:

https://hummytummy.com/api

Tüm REST yolları /api global ön ekiyle servis edilir. Bu dokümandaki her örnekte tam yol gösterilir (örn. POST /api/v1/webhooks/subscriptions). Para birimi her zaman TRY’dir.

Hangi entegrasyon size uygun?

HummyTummy üç ayrı entegrasyon yüzeyi sunar; çoğu entegratör birden fazlasını birlikte kullanır.

Taban URL, kimlik gerçeklikleri (personel JWT / müşteri oturumu / partner anahtarı / ekran token’ı), X-Branch-Id şube kapsamı, sayfalama, hata zarfı, idempotency ve rate-limit katmanları.

API Temelleri

Masa tableti gibi kendi ekranlarınızı çalıştırın: menü, sipariş, garson/hesap çağrısı, self-servis ödeme ve canlı sipariş durumu. ADMIN anahtarı → ekran token’ı → /v1/display/* + WebSocket.

Partner Display API

Sipariş, ödeme ve abonelik olaylarını HMAC-SHA256 imzalı POST’larla kendi uç noktanıza alın. Abonelik, imza doğrulama, olay tipleri, yeniden deneme ve SSRF koruması.

Webhook'lar

İki yön: çekme (pull) ve itme (push)

Çekme — REST uçlarını siz çağırırsınız (menü okuma, sipariş oluşturma, ödeme başlatma). Kimlik ve şube kapsamı kuralları için API Temelleri.
İtme — bir olay olduğunda biz sizin uç noktanıza POST atarız (giden webhook’lar). Kurulum ve doğrulama için Webhook’lar.

Yetkilendirme katmanları (kısa özet)

Realm	Nasıl kimlik doğrular	Tipik kullanım
Personel JWT	`Authorization: Bearer <jwt>`	Dashboard / yönetim API’si, anahtar & webhook yönetimi
Müşteri oturumu	QR menü oturum token’ı	Misafir sipariş & self-pay
Partner anahtarı	`X-Partner-Key` + `X-Partner-Secret`	Partner backend’i ekran token’ı üretir
Ekran token’ı	`Authorization: Screen <token>`	Cihaz `/v1/display/*` çağırır

Her birinin tam ayrıntısı API Temelleri sayfasında.

⚠️

Partner Display ve giden webhook’lar plana bağlı özelliklerdir. Partner Display için tenant planının externalDisplay, webhook abonelikleri için apiAccess (API erişimi) özelliğini içermesi gerekir. Aksi halde ilgili uçlar 403 döner.

Ana Sayfa API Temelleri