Genel Bilgiler
Sistem Mimarisi
BK Yemek API yapısı RESTful standartlara uygun olarak geliştirilmiştir. Tüm veri alışverişleri `JSON` formatında yapılmakta ve `HTTPS` protokolü ile güvenli hale getirilmektedir.
Yetkilendirme
Her restoran için özel bir API Key ve API Secret üretilir. Tüm API çağrılarında bu bilgiler header üzerinden gönderilmelidir:
X-API-KEY: xxxxxxxxxxxxxxxxxxxx
X-API-SECRET: yyyyyyyyyyyyyyyyyy
Bu bilgiler olmadan yapılan çağrılar geçersiz kabul edilir ve işlem yapılmaz.
Veri Akışı
Sipariş akışı iki yönlüdür:
- BK Yemek ⟶ POS: Yeni sipariş iletimi ve sipariş durumu güncellemeleri
- POS ⟶ BK Yemek: Sipariş durumu değişikliği ve teslimat bilgileri
Desteklenen İçerikler
Gönderilen siparişlerde aşağıdaki veri alanları desteklenmektedir:
- Kullanıcı bilgileri (ad, telefon)
- Adres ve konum (enlem, boylam)
- Ürünler ve tercihleri
- Ödeme türü ve tutarlar
- Kuryeye özel notlar
Detaylı veri alanları, sonraki sayfalarda (Sipariş Gönderimi ve Sipariş Örneği) açıklanacaktır.