Geliştiriciler

Her Gustu menüsü, tek bir istek uzağınızda.

Gustu'daki restoranlar menülerini yapılandırılmış veri olarak yayınlar. Asistanlar, arama motorları ve sizin kodunuz bu menüleri kazımadan okuyabilir: tek bir GET, API anahtarı yok.

Uç nokta

GET https://menu.gustu.ai/api/public/v1/restaurants/{slug}/menu
slug
Restoranın kısa adı, menu.gustu.ai/r/{slug} adresindeki gibi.
branch
İsteğe bağlı. Şubenin kısa adı; restoranın birden fazla şubesi varsa gerekli.
lang
İsteğe bağlı. tr, en veya de gibi bir dil kodu. Verilmezse restoranın kendi dili kullanılır.

Örnek

curl https://menu.gustu.ai/api/public/v1/restaurants/cil/menu
{
  "schemaVersion": 1,
  "language": "tr",
  "restaurant": {
    "slug": "cil",
    "name": "Çil"
  },
  "branch": {
    "slug": "moda",
    "name": "Moda",
    "address": "Caferağa, Moda Cd. No:101, 34710 Kadıköy/İstanbul, Türkiye"
  },
  "priceRange": {
    "min": 425,
    "max": 1495,
    "currency": "TRY"
  },
  "itemCount": 115,
  "sections": [
    {
      "name": "Paylaşımlıklar",
      "items": [
        {
          "name": "Bruschetta Üçlüsü",
          "price": 675,
          "currency": "TRY",
          "dietTags": [],
          "allergens": [
            "gluten",
            "milk",
            "fish"
          ],
          "calories": 160,
          "url": "https://menu.gustu.ai/t/12c463aa-e927-4287-98e9-a7471d6641fb/a4292279-8c0b-4d94-9216-50332cdf57e9/item/66c917d4-0d9f-4ed5-aebf-6d4c5697acde"
        }
      ]
    }
  ],
  "dietaryCoverage": {
    "gluten_free": 1,
    "high_protein": 1,
    "vegan": 4,
    "vegetarian": 18
  },
  "disclaimer": "Alerjen ve diyet bilgileri restoranın menü verisinden gelir. Mutfaklarda çapraz bulaşma olabilir; ciddi alerjisi olan misafirler sipariş vermeden önce personele danışmalıdır."
}

Moda'daki Çil için gerçek bir yanıt, tek yemeğe kısaltılmış. Tam yanıt her bölümdeki tüm mevcut yemekleri listeler.

Bir asistandan kullanın

Aynı menüler bir MCP sunucusu olarak da açık. Claude gibi bir asistan bir restoranı bulabilir, yemeklerini kesin diyet, alerjen ve fiyat filtreleriyle arayabilir ve tek bir yemeği açabilir. Anahtar ve oturum açma yok; restoran her aracın bir parametresidir.

https://menu.gustu.ai/api/public/mcp

Claude Code

claude mcp add --transport http gustu https://menu.gustu.ai/api/public/mcp

claude.ai

  1. Ayarlar'ı, ardından Bağlayıcılar'ı açın.
  2. Özel bağlayıcı ekle'yi seçin.
  3. Adını Gustu koyun, yukarıdaki sunucu adresini yapıştırın ve kaydedin.
  4. Yeni bir sohbette bölge ya da mutfakla restoran isteyin, örneğin Kadıköy'de balık, ya da bir restoranı kısa adıyla sorun, örneğin cil.

Araçlar

find_restaurants
Türkiye'de bir bölgedeki, bir mutfaktaki ya da ikisine birden uyan Gustu restoranları, yalnızca alaka sırasıyla. Tarih verilirse masa talebi alanlar boş saatleriyle gelir.
get_restaurant
Restoranın profili ve kısa bir menü: bölümler, yemek adları, fiyatlar ve etiketler. Seçmeniz gerektiğinde şubeleri listeler.
search_menu
Herhangi bir dilde yazılmış bir isteğe uyan yemekler; diyet, hariç tutulan alerjenler, en yüksek fiyat ve yemek türüne göre kesin filtrelenir. En fazla on sonuç.
get_item
Tek bir yemeğin tamamı: açıklama, fiyat, diyet etiketleri, alerjenler ve kalori, sayfasının bağlantısıyla.
check_availability
Bir kişi sayısı için boş masa saatleri, bir ila yedi gün için, restoranın yerel saatiyle.
create_reservation
Misafirin adı, telefonu ve e-postasıyla masa ister. Masayı on dakika tutar ve misafire kodla birlikte Gustu doğrulama bağlantısını e-postalar.
confirm_reservation
Marketing.developersPage.mcp.tools.confirm_reservation
get_reservation
Talebin durumu: restoranın cevabını bekliyor, onaylandı, reddedildi ya da iptal edildi.
cancel_reservation
Misafirin iptal etmek istediği rezervasyonu iptal eder.

Masa talebi, restoran kabul edene kadar rezervasyon değildir. Restoran Gustu panosundan onaylar ya da reddeder, misafire cevap e-postayla gider. Yalnızca çalışma saatlerini Gustu'ya girmiş restoranlar talep alır.

Chat API: asistan kendi ürününüzde

Gustu'daki restoranların masa QR kodlarında menüyü bilen bir asistan var. Restoranın verdiği bir API anahtarıyla aynı asistan sizin yazılımınızdan yanıt verir: bir WhatsApp botu, bir web sitesi widget'ı, bir kiosk. Bir mesaj girer, yemek kartlarıyla bir yanıt çıkar; turların bedeli restoranın planından düşer.

POST https://menu.gustu.ai/api/public/v1/chat

Anahtar almak

Anahtar restorana aittir. Restoran sahibi Gustu'da Ayarlar → API altında bir anahtar oluşturur, isterse tek bir şubeyle sınırlar ve size verir. Anahtarın tamamı yalnızca oluşturulduğu anda gösterilir; Gustu sadece bir parmak izi saklar. Sunucunuzdan, bearer token olarak gönderin.

Örnek

curl https://menu.gustu.ai/api/public/v1/chat \
  -H "Authorization: Bearer gk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "message": "Paylaşmak için hafif bir başlangıç var mı?", "branch": "moda" }'
{
  "conversation_id": "a4292279-8c0b-4d94-9216-50332cdf57e9-58f1169a-977f-475c-b4dc-99d83b4c4dd7",
  "language": "tr",
  "text": "Paylaşımlık tabaklarda daha hafif hissettiren seçenekler de var.",
  "items": [
    {
      "id": "01ea41f5-67b1-4637-9897-081731a804b1",
      "name": "Kabuklu Edamame",
      "description": "Sade veya soslu servis",
      "price": 425,
      "currency": "TRY",
      "imageUrl": "https://wputtpujubqiqyfmnlau.supabase.co/storage/v1/object/public/menu-images/menu-items/cil/01ea41f5-67b1-4637-9897-081731a804b1-67zjwn.webp",
      "url": "https://menu.gustu.ai/t/12c463aa-e927-4287-98e9-a7471d6641fb/a4292279-8c0b-4d94-9216-50332cdf57e9/item/01ea41f5-67b1-4637-9897-081731a804b1",
      "category": "Paylaşımlıklar",
      "isAvailable": true,
      "dietTags": [
        "vegan"
      ],
      "allergens": [
        "soybeans"
      ],
      "reason": "Sade edamame, taze ve hafif bir paylaşmalık başlangıç arıyorsanız iyi bir seçenek; menüde vegan olarak etiketli. Alerjen bilgisinde soya belirtiliyor."
    },
    {
      "id": "bfe4bf53-bbee-4936-a6bf-ed6aa99d0e81",
      "name": "Enginar & Burrata",
      "description": "Fırınlanmış Kekikli Enginar Kalbi, Kuzukulağı, Baby Ispanak, Burrata Peyniri, Narenciye Vinegret, Edamame",
      "price": 745,
      "currency": "TRY",
      "imageUrl": "https://wputtpujubqiqyfmnlau.supabase.co/storage/v1/object/public/menu-images/menu-items/cil-2/bfe4bf53-bbee-4936-a6bf-ed6aa99d0e81-xlpkho.webp",
      "url": "https://menu.gustu.ai/t/12c463aa-e927-4287-98e9-a7471d6641fb/a4292279-8c0b-4d94-9216-50332cdf57e9/item/bfe4bf53-bbee-4936-a6bf-ed6aa99d0e81",
      "category": "Paylaşımlıklar",
      "isAvailable": true,
      "dietTags": [
        "vegetarian"
      ],
      "allergens": [
        "milk"
      ],
      "reason": "Enginar, yeşillikler ve narenciye vinegretli bu tabak, daha taze ve ferah bir paylaşmalık arıyorsanız öne çıkıyor. Menüde vejetaryen olarak etiketli."
    }
  ],
  "suggestions": [
    {
      "label": "Salatalara bak",
      "message": "Salataları gösterir misiniz?",
      "itemId": null
    },
    {
      "label": "Bir içecek öner",
      "message": "Bu başlangıçlara eşlik edecek bir içecek önerir misiniz?",
      "itemId": null
    }
  ],
  "usage": {
    "turn": 1,
    "turns_remaining_in_conversation": 99,
    "credits_remaining": 8087
  },
  "request_id": "f9712b0f-ee3d-4577-ae41-c36056b5562d"
}

Moda'daki Çil için 1 Kasım 2026'da kaydedilmiş gerçek bir yanıt, kısaltılmış: üç karttan ikisi ve dört devam sorusundan ikisi gösteriliyor. Asistanın cümleleri çağrıdan çağrıya değişir; yanıtın biçimi değişmez.

Konuşmayı sürdürmek

Geçmişi sunucu tutar. Sonraki mesajı son yanıttaki conversation_id ile gönderin; asistan söylenenleri hatırlar. Yeni bir konuşma için göndermeyin; yalnızca Gustu'nun verdiği kimlikler kabul edilir.

{ "message": "Salataları gösterir misiniz?",
  "conversation_id": "a4292279-8c0b-4d94-9216-50332cdf57e9-58f1169a-977f-475c-b4dc-99d83b4c4dd7" }

Akış

Tek bir JSON gövdesi yerine sunucu olayları almak için stream alanını true yapın: önce meta, asistan yazarken text parçaları, bir yemek kartı hazır olunca items ve suggestions, sonunda kullanım satırıyla done ya da error.

event: meta
data: {"conversation_id": "a4292279-8c0b-4d94-9216-50332cdf57e9-5fb9959e-aaf0-4578-8c72-f3f6310b407e", "language": "tr", "request_id": "37c8fd5b-166e-48fe-8e06-e98e187ac8cf"}

event: text
data: {"delta": "Pay"}

event: text
data: {"delta": "laşıma u"}

: 16 more text events

event: text
data: {"delta": "kler de var."}

event: items
data: {"items": [{"id": "bfe4bf53-bbee-4936-a6bf-ed6aa99d0e81", "name": "Enginar & Burrata", "description": "Fırınlanmış Kekikli Enginar Kalbi, Kuzukulağı, Baby Ispanak, Burrata Peyniri, Narenciye Vinegret, Edamame", "price": 745, "currency": "TRY", "imageUrl": "https://wputtpujubqiqyfmnlau.supabase.co/storage/v1/object/public/menu-images/menu-items/cil-2/bfe4bf53-bbee-4936-a6bf-ed6aa99d0e81-xlpkho.webp", "url": "https://menu.gustu.ai/t/12c463aa-e927-4287-98e9-a7471d6641fb/a4292279-8c0b-4d94-9216-50332cdf57e9/item/bfe4bf53-bbee-4936-a6bf-ed6aa99d0e81", "category": "Paylaşımlıklar", "isAvailable": true, "dietTags": ["vegetarian"], "allergens": ["milk"], "reason": "Paylaşmak için 3-4 kişilik olarak sunuluyor; enginar, kuzukulağı ve narenciye vinegretinin ferah-ekşimsi notaları zengin burratayla dengeleniyor."}]}

event: suggestions
data: {"suggestions": [{"label": "Salatalara bak", "message": "Salataları gösterir misiniz?", "itemId": null}, {"label": "Taze portakal suyu", "message": "Taze Portakal Suyu hakkında bilgi verir misiniz?", "itemId": "4b1ffc26-a027-447e-9edb-814c65d17f71"}]}

event: done
data: {"usage": {"turn": 1, "turns_remaining_in_conversation": 99, "credits_remaining": 8085}, "request_id": "37c8fd5b-166e-48fe-8e06-e98e187ac8cf"}

Moda'daki Çil için 1 Kasım 2026'da kaydedilmiş gerçek bir akış, bir bölümü gösteriliyor: 19 text olayından üçü, üç karttan biri ve dört devam sorusundan ikisi. İki noktayla başlayan satır kesilen yeri işaretler; API böyle bir satır göndermez.

Nasıl davranır

  • Yanıtlanan her tur restoranın kendi planından düşer. Zaman aşımı (504) ya da boş bir yanıt faturalanmaz. Her yanıttaki usage satırı kalanı söyler.
  • Sunucunuzdan çağırın. Tarayıcı Origin başlığı taşıyan bir istek, anahtar o origin'i listelemiyorsa 403 origin_not_allowed ile reddedilir; böylece tarayıcıya sızan bir anahtar restoranın turlarını harcayamaz.
  • Sınırlar anahtar başınadır: dakikada istek (varsayılan 60) ve isteğe bağlı günlük maliyet tavanı; ikisini de restoran sahibi anahtar üzerinde belirler. Aşılırsa Retry-After ile 429 döner. Sınırlayıcının kendisine ulaşılamazsa istek ölçülmeden geçirilmez, 503 ile reddedilir.
  • Tek şubeye sınırlı bir anahtar yalnızca o şube için yanıt verir; başka bir şube istenirse 403 branch_not_allowed döner. Çok şubeli bir restoranda sınırsız anahtar şubeyi belirtmelidir, yoksa şube listesiyle 400 branch_required alır.
  • Kartlar menüden gelir. Her ögenin adı, fiyatı, diyet etiketleri, alerjenleri ve bağlantısı restoranın verisidir, modelin değil; metin asistanındır.
  • İptal edilen anahtar anında durur: 403 api_key_revoked. Herkese açık yüzeyini kapatan bir restoran bu API'yi de kapatır (403 surface_disabled).
  • Her red { error: { code, message } } biçimindedir. Kodlar ve istek şeması aşağıdaki OpenAPI tanımında.

Nasıl davranır

  • Kimlik doğrulama ve anahtar yok. CORS açık, tarayıcıdan da çağırabilirsiniz.
  • Yanıtlar beş dakika önbelleklenir. Menüdeki bir değişiklik API'ye bu süre içinde yansır.
  • Hız sınırı: IP başına dakikada 60 istek. Aşılırsa Retry-After ile 429 döner.
  • Birden fazla şubesi olan bir restoran, ?branch= ile şube seçilene kadar şube listesiyle 300 döner.
  • Karar restoranın: Gustu'da herkese açık menüyü kapatan bir işletme burada 403 döner ve hiçbir yerde yapılandırılmış veri yayınlanmaz.
  • Sürüm 1 yalnızca büyür. Yeni isteğe bağlı alanlar eklenebilir; /v2 olmadan hiçbir alan kaldırılmaz veya yeniden adlandırılmaz.

Alerjen verisi hakkında

Alerjenler ve diyet etiketleri restoranın kendi menü verisinden gelir. Mutfaklarda çapraz bulaşma olabilir; bu yüzden her yanıt bir uyarı taşır. Uyarıyı gösterin ve bir etiket eksik diye bir misafire yemeğin bir şeyi içermediğini söylemeyin.

Ayrıca

Bunun üzerine bir şey mi geliştiriyorsunuz? Bize yazın.

Herkese açık menü ve chat API'si — Gustu