Giriş
AloYemek Entegrasyon API nedir, kimler kullanabilir?
AloYemek Entegrasyon API, POS, adisyon, kurye ve restoran yönetim yazılımlarının AloYemek'teki restoranlara güvenli şekilde bağlanmasını sağlar. Restoranlar AloYemek paneline girmeden, alıştıkları programdan siparişlerini alır, kabul eder, hazırlar ve teslim eder; menülerini ve sipariş alım durumlarını da aynı yerden yönetir.
Sipariş yönetimi
Yeni siparişler anında webhook ile gelir. Kabul, red, hazır, yolda ve teslim işlemleri tek istekle yapılır.
Menü yönetimi
Menüyü okuyun, tükenen ürün ve seçenekleri kapatın, fiyatları POS'unuzdan güncelleyin.
Restoran durumu
Yoğunlukta sipariş alımını durdurun, süre dolunca otomatik açılsın; çalışma saatlerini okuyun.
Kimler kullanabilir?
API, AloYemek tarafından onaylanan entegrasyon firmalarına açıktır: POS ve adisyon yazılımları, çok kanallı sipariş toplama platformları, kurye / paket takip yazılımları ve kendi yazılımını geliştiren restoran zincirleri.
Başvurunuz onaylandıktan sonra hangi restoranların verisine erişeceğinize restoranın kendisi karar verir: restoran, AloYemek panelinde firmanızı seçip izin verdiğinde size özel bir restoran anahtarı oluşturur.
Temel bilgiler
| Temel adres | https://www.aloyemek.com/aloapi/v1 |
|---|---|
| Biçim | JSON (UTF-8). İstek gövdesi Content-Type: application/json ile gönderilir. |
| Kimlik doğrulama | Bearer token (ayrıntılar) |
| Anlık bildirim | İmzalı webhook (ayrıntılar) |
| Saat dilimi | Tarihler ISO 8601, saat dilimi bilgisiyle (2026-09-17T17:18:19+03:00) |
| Para birimi | Türk lirası; tutarlar KDV dahil, iki ondalık basamaklı sayı |
| Sürüm | v1 — geriye uyumsuz değişiklikler yeni sürüm adresinde yayınlanır |
Yanıt biçimi
Tüm yanıtlar aynı zarfı kullanır. Başarılı isteklerde success: true ve data, hatalarda success: false ve error döner. HTTP durum kodu da her zaman anlamlıdır (200, 401, 403, 404, 409, 422, 429, 500).
{
"success": true,
"data": { … }
}{
"success": false,
"error": {
"code": "INVALID_STATUS_TRANSITION",
"message": "Action \"delivered\" is not allowed for an order in status \"new\" (delivery)."
}
}message alanı geliştiriciler içindir ve değişebilir; programınızda karar verirken her zaman code alanını kullanın. Tüm kodlar Hata kodları sayfasındadır.