Nasıl çalışır?
Firma, restoran ve AloYemek arasındaki akış
Entegrasyon üç taraf arasında kurulur: AloYemek, entegrasyon firması (siz) ve restoran. Her restoran bağlantısı ayrı bir anahtarla yapılır; restoran bağlantıyı istediği an kaldırabilir.
Onay
AloYemek başvuruyu inceler; onayda size appSecretKey ve webhook imza anahtarı iletilir.
Restoran bağlanır
Restoran panelinde API entegrasyonları sayfasından firmanızı seçer, izinleri onaylar ve restaurantSecretKey oluşturur.
Token
POS'unuz iki anahtarla /auth/login çağırır ve 24 saat geçerli token alır.
Siparişler akar
Yeni sipariş webhook ile gelir; POS'unuz kabul eder, hazır ve teslim edildi yapar.
Anahtarlar ve kimlikler
| Anahtar | Kimde? | Ne işe yarar? |
|---|---|---|
appSecretKeyayk_app_… | Firma (bir tane) | Firmanızı tanımlar. Sunucunuzda saklayın; restorana veya son kullanıcı cihazına koymayın. |
restaurantSecretKeyayk_rst_… | Restoran başına bir tane | Restoranın size verdiği yetkidir. Restoran panelinde oluşturulur, POS kurulumunda girilir. |
token | Restoran başına, 24 saat | Tüm API isteklerinde Authorization: Bearer başlığında gönderilir. |
webhookSecretwhsec_… | Firma | Size gelen webhook isteklerinin AloYemek'ten geldiğini doğrulamak içindir. |
restaurantId | Herkese açık | Restoranın kalıcı kimliği (uuid). Webhooklarda ve giriş yanıtında döner; kendi sisteminizde eşleştirme için kullanın. |
Sipariş akışı
Sipariş her aşamada rejected (red) veya delivery failed (teslim edilemedi) ile kapanabilir. Ayrıntılar ve izin verilen geçişler Sipariş yönetimi sayfasındadır.
Webhook mi, sorgulama mı?
Önerilen yöntem webhook'tur: yeni sipariş birkaç saniye içinde sunucunuza gelir. Webhook adresi olmayan veya yerel ağda çalışan POS'lar /orders/active ucunu 15–30 saniyede bir sorgulayabilir. En sağlam kurgu ikisini birlikte kullanmaktır: webhook ile anında alın, uygulama açılışında ve bağlantı koptuktan sonra aktif siparişleri sorgulayarak eşitleyin.