Masada menüsünü kendi sisteminize bağlayın.

Fiyatı panelde değiştirin; web siteniz, dijital ekranınız ya da otel sisteminiz aynı veriyi buradan çeksin.

Anahtar al Örneği gör

Menünüzde

Türk Kahvesi 145,00 ₺

Bakır cezvede, közde pişirilir.

GET api.masada.tr/v1/menu

{
  "name": {
    "tr": "Türk Kahvesi",
    "en": "Turkish Coffee"
  },
  "price": "145.00",
  "is_sold_out": false
}

Başlarken

Teknik bilginiz yoksa bu sayfanın adresini yazılımcınıza göndermeniz yeterli. Anahtarı yalnız işletme sahibi üretebilir.

1

İşletme Ayarları sayfasını açın

Panelin sol menüsünde bulunur. Sayfanın en altında "Menü API Anahtarı" kartı vardır.
2

Anahtar üretin

"Anahtar üret" düğmesine basın. msd_ ile başlayan anahtar yalnız bir kez gösterilir, hemen kopyalayın.
3

Yazılımcınıza iletin

Anahtar her istekte Authorization: Bearer başlığıyla gönderilir. Adres her zaman https://api.masada.tr ile başlar.

Menü ve fiyatlar

GET /v1/menu isteğinde anahtar hangi işletmeye aitse onun yayındaki menüleri gelir: kategoriler, ürünler, fiyatlar, seçenekler ve görseller. Sıralama paneldeki sırayla aynıdır.

Misafire görünmeyen ürünler ve stok adedi gibi iç bilgiler yanıtta yer almaz.

curl https://api.masada.tr/v1/menu \
  -H "Authorization: Bearer $MASADA_API_KEY"

$context = stream_context_create(['http' => [
    'header' => 'Authorization: Bearer '.getenv('MASADA_API_KEY'),
]]);

$body = file_get_contents('https://api.masada.tr/v1/menu', false, $context);
$menu = json_decode($body, true);

const response = await fetch('https://api.masada.tr/v1/menu', {
  headers: { Authorization: `Bearer ${process.env.MASADA_API_KEY}` },
});

const menu = await response.json();

Yanıt (kısaltılmış örnek)

{
  "business": {
    "name": "Asmalı Kahve",
    "slug": "asmali-kahve",
    "currency": "TRY"
  },
  "menus": [
    {
      "id": 12,
      "name": {
        "tr": "Ana Menü",
        "en": "Main Menu"
      },
      "categories": [
        {
          "id": 48,
          "name": {
            "tr": "Sıcak İçecekler",
            "en": "Hot Drinks"
          },
          "products": [
            {
              "id": 311,
              "name": {
                "tr": "Türk Kahvesi",
                "en": "Turkish Coffee"
              },
              "description": {
                "tr": "Bakır cezvede, közde pişirilir.",
                "en": "Brewed in a copper cezve over embers."
              },
              "price": "145.00",
              "calories": 12,
              "allergens": [],
              "tags": [
                "popular"
              ],
              "is_sold_out": false,
              "image_url": "https://masada.tr/storage/products/turk-kahvesi.webp",
              "variants": [],
              "modifier_groups": [
                {
                  "id": 27,
                  "name": {
                    "tr": "Şeker",
                    "en": "Sugar"
                  },
                  "is_required": true,
                  "min_select": 1,
                  "max_select": 1,
                  "options": [
                    {
                      "id": 81,
                      "name": {
                        "tr": "Sade",
                        "en": "No sugar"
                      },
                      "price_delta": "0.00",
                      "is_sold_out": false
                    },
                    {
                      "id": 82,
                      "name": {
                        "tr": "Orta",
                        "en": "Medium"
                      },
                      "price_delta": "0.00",
                      "is_sold_out": false
                    }
                  ]
                }
              ]
            },
            {
              "id": 314,
              "name": {
                "tr": "Filtre Kahve",
                "en": "Filter Coffee"
              },
              "description": {
                "tr": "Günün çekirdeğiyle demlenir."
              },
              "price": null,
              "calories": null,
              "allergens": [],
              "tags": [],
              "is_sold_out": false,
              "image_url": null,
              "variants": [
                {
                  "id": 55,
                  "name": {
                    "tr": "Küçük",
                    "en": "Small"
                  },
                  "price": "120.00",
                  "is_sold_out": false
                },
                {
                  "id": 56,
                  "name": {
                    "tr": "Büyük",
                    "en": "Large"
                  },
                  "price": "150.00",
                  "is_sold_out": true
                }
              ],
              "modifier_groups": []
            }
          ]
        }
      ]
    }
  ]
}

Alanların anlamı

name, description: Dil kodu ile metin eşleşmesi: {"tr": "...", "en": "..."}. Yalnız işletmenin doldurduğu diller gelir; aradığınız dil yoksa tr değerini gösterin.
price: Noktalı metin, iki ondalık: "145.00". Para birimi business.currency alanındadır. null ise ürünün fiyatı boy ve porsiyon seçeneklerindedir (variants).
variants: Boy ya da porsiyon gibi seçenekler. Her biri kendi fiyatını taşır.
modifier_groups: Şeker, süt, ekstra gibi eklentiler. min_select ve max_select seçilebilecek adedi söyler; price_delta seçenek alınırsa fiyata eklenen tutardır.
is_sold_out: true ise ürün listede kalır ama "tükendi" olarak gösterilmelidir. Ürün, seçenek ve eklentilerde ayrı ayrı bulunur.
allergens: gluten, crustaceans, eggs, fish, peanuts, soybeans, milk, tree_nuts, celery, mustard, sesame, sulphites, lupin, molluscs değerlerinden oluşan liste.
tags: vegan, vegetarian, spicy, new, popular, gluten_free, lactose_free, sugar_free değerlerinden oluşan liste.
calories, image_url: Girilmemişse null gelir. image_url tam adrestir, doğrudan kullanılabilir.

curl https://api.masada.tr/v1/bayi

$plans = json_decode(file_get_contents('https://api.masada.tr/v1/bayi'), true);

const plans = await (await fetch('https://api.masada.tr/v1/bayi')).json();

Yanıt (kısaltılmış örnek)

{
  "currency": "TRY",
  "kdv_rate": 20,
  "plans": [
    {
      "slug": "pro",
      "name": "Menü Paketi",
      "is_contact_only": false,
      "limits": {
        "businesses": 1,
        "menus_per_business": 9999,
        "products_per_business": 99999,
        "tables_per_business": 9999,
        "locales": 6
      },
      "features": {
        "multi_language": true,
        "orders": false,
        "ai_assistant": false
      },
      "terms": [
        {
          "key": "m1",
          "label": "1 Ay",
          "months": 1,
          "net_kurus": 150000,
          "gross_kurus": 180000
        },
        {
          "key": "y1",
          "label": "1 Yıl",
          "months": 12,
          "net_kurus": 600000,
          "gross_kurus": 720000
        }
      ]
    }
  ]
}

Paket fiyatları

Bayiler Masada paketlerini ve süreye göre fiyatlarını GET /v1/bayi ile çekip kendi sitelerinde güncel gösterebilir. Anahtar gerekmez.

Tutarlar kuruştur: 180000 = 1.800,00 ₺.
net_kurus KDV hariç, gross_kurus KDV dahil tutardır. Oran kdv_rate alanındadır.
is_contact_only true olan pakette fiyat listesi boş gelir; bu paket için müşteriyi bize yönlendirin.

Güncel kalma

Menüyü her ziyaretçide değil, birkaç dakikada bir çekip saklayın. Her yanıtla bir ETag değeri gelir. Bir sonraki istekte bunu If-None-Match başlığıyla gönderin.

Menü değişmediyse yanıt boş ve 304 kodlu döner; elinizdeki kopya hâlâ günceldir. İki uçta da aynı şekilde çalışır.

cURL

curl -i https://api.masada.tr/v1/menu \
  -H "Authorization: Bearer $MASADA_API_KEY" \
  -H 'If-None-Match: "<son yanıttaki ETag>"'

HTTP/2 304

Hatalar ve sınırlar

Hatalar her zaman JSON döner ve açıklama message alanındadır.

Kod	Ne zaman	Ne yapmalı
304	If-None-Match ile gönderdiğiniz ETag güncel. Menü değişmedi.	Elinizdeki kopyayı kullanmaya devam edin.
401	"Geçersiz ya da eksik API anahtarı." Anahtar yok, yanlış ya da işletme yeni anahtar üretmiş.	İşletmeden güncel anahtarı isteyin.
403	"İşletmenin menüsü şu an yayında değil." İşletme menüsünü yayından kaldırmış.	Son kopyayı gösterin, yeniden yayına alınınca veri gelir.
429	Dakikalık istek sınırı aşıldı.	Retry-After başlığındaki saniye kadar bekleyip tekrar deneyin.

60/ dk

Her anahtar dakikada 60 istek yapabilir. Anahtarsız isteklerde sınır IP başınadır. Bir IP adresinden toplamda dakikada en çok 300 istek kabul edilir.

Farklı bir ihtiyacınız varsa bize yazın: destek@masada.tr