Softelliomenü

Geliştiriciler için

Menünüz bir API: POS, sadakat ve web sitenizle konuşur

Menü verisi tek yerde yaşar; kalan sistemleriniz okur. Değişiklikte webhook kapınızı çalar.

GET /api/v1/menu?lang=en
{
  "categories": [{
    "name": "Breakfast",
    "products": [{
      "name": "Turkish Breakfast",
      "price": 850,
      "calorie": 950,
      "allergens": ["gluten", "sut"]
    }]
  }],
  "generated_at": "2026-07-07T09:41:00Z"
}
→ webhook: menu.updated · X-Softellio-Signature: sha256=✓

Scope'lu, salt-okunur anahtarlar

Panelden saniyede API anahtarı üretirsiniz: 'menüyü oku' ve 'fiyatları oku' yetkileri ayrı ayrı verilebilir, dakikalık istek limiti anahtara özeldir. Anahtar yalnızca üretildiği anda gösterilir; kullanım sayacı ve son kullanım zamanı panelde izlenir, tek tıkla iptal edilir.

ETag destekli uç noktalar

GET /api/v1/menu tüm kategori ağacını döner; /products sayfalı liste, /categories, /outlets ve /allergens yardımcı uç noktalardır. Yanıtlar ETag taşır — If-None-Match ile 304 alır, bant genişliğini boşa harcamazsınız. Dil (?lang=) ve şube (?outlet=) parametreleri hazırdır.

  • GET /api/v1/menu — kategori ağacı + ürünler
  • GET /api/v1/products — sayfalı, filtreli
  • ?lang= ile çevrilmiş, ?outlet= ile şubeye özel yanıt
  • ?updated_since= ile yalnızca değişeni çekin

menu.updated webhook'u

Menü her değiştiğinde kayıtlı adresinize HMAC-SHA256 imzalı bir POST gider (X-Softellio-Signature başlığıyla doğrularsınız). Bildirimi alan sisteminiz ?updated_since= ile sadece değişeni çeker — POS ekranlarınız, dijital tabelalarınız, web siteniz menüyle hep senkron kalır.

Sık sorulanlar

API & Webhook hakkında merak edilenler

API ile menüyü değiştirebilir miyim?+

Hayır — API bilinçli olarak salt-okunurdur. Menü değişikliği yalnızca yetkili panel kullanıcılarınca yapılır; entegrasyonlar okur, bozamaz.

Rate limit nasıl çalışıyor?+

Anahtar başına dakikalık limit siz belirlersiniz (varsayılan 60). Aşımda 429 döner; ETag kullanan istemciler limiti nadiren zorlar.

Webhook imzasını nasıl doğrularım?+

Gövdenin HMAC-SHA256 imzası X-Softellio-Signature başlığında gelir; kayıt sırasında verilen gizli anahtarla karşılaştırırsınız. Örnek kod panelde hazırdır.

API & Webhook dahil her şey — 14 gün ücretsiz

Kart bilgisi girmeden vazgeçebilirsiniz; deneme bitmeden iptalde ücret alınmaz.

Hemen başla