Menünüzü kendi sitenizde ve uygulamanızda kullanın
Tek bir istekle restoranınızın menüsünü, kategorilerini ve ürünlerini JSON olarak alırsınız. Anahtarınızı Menuz panelinde Özel Ayarlar > API erişimi sayfasından oluşturursunuz.
Genel bakış
Menuz API, menünüzü kendi web sitenizde, mobil uygulamanızda, kiosk ya da dijital ekranlarınızda göstermeniz için menü verisini JSON olarak verir. Panelde yaptığınız her değişiklik (fiyat, ürün, tükendi durumu) bir sonraki istekte yansır.
- Adres
https://mail.menuz.com.tr/api/public-menu.php - Biçim
application/json; charset=utf-8 - ErişimSalt okunur (GET)
- PlanZincir ve Resort planlarında
Kimlik doğrulama
Her istekte API anahtarınızı X-API-Key başlığıyla gönderin. Anahtar hesabınıza bağlıdır; yalnızca kendi restoranlarınızın verisine erişir.
X-API-Key: YOUR_API_KEYBaşlık ekleyemediğiniz ortamlarda anahtarı api_key sorgu parametresiyle de gönderebilirsiniz. Adresler sunucu kayıtlarında görünebildiği için başlık kullanmanızı öneririz.
https://mail.menuz.com.tr/api/public-menu.php?restaurant=lale-kahve&api_key=YOUR_API_KEYUç nokta
/api/public-menu.phpBir restoranın profilini, aktif menülerini, kategorilerini ve ürünlerini tek yanıtta döndürür.
| Parametre | Konum | Zorunlu | Açıklama |
|---|---|---|---|
restaurant | query | Evet | Restoranın menü adresindeki kısa adı. Örnek: menuz.com.tr/m/lale-kahve |
X-API-Key | header | Evet | API anahtarınız. |
api_key | query | Hayır | Başlık yerine kullanılabilir. |
Yanıt yapısı
Başarılı yanıt ok: true ile başlar. Fiyatlar ondalık metin olarak gelir ("85.00"); para birimi restaurant.currency alanındadır. is_available ve is_featured 1 ya da 0 değerini alır.
restaurantRestoranın profil bilgileri.
menus[]Yalnızca aktif menüler, oluşturulma sırasıyla.
categories[]Paneldeki sırasıyla (sort_order).
items[]Tükendi işaretli ürünler de gelir (is_available = 0).
{
"ok": true,
"restaurant": {
"id": 1,
"user_id": 2,
"name": "Lale Kahve",
"slug": "lale-kahve",
"emoji": null,
"icon": "coffee",
"description": null,
"address": null,
"phone": null,
"currency": "TRY",
"currency_symbol": "₺",
"menu_theme": "kahve",
"cover_url": "/assets/uploads/covers/cover-1.webp",
"theme_color": "#9a3412"
},
"menus": [
{
"id": 1,
"name": "Ana Menü",
"categories": [
{
"id": 2,
"menu_id": 1,
"name": "Sıcak Kahveler",
"emoji": null,
"icon": "coffee",
"sort_order": 0,
"items": [
{
"id": 5,
"category_id": 2,
"name": "Türk kahvesi",
"description": "Bakır cezvede, yanında lokum ile.",
"price": "85.00",
"image_url": null,
"emoji": null,
"icon": "coffee",
"is_available": 1,
"is_featured": 1,
"sort_order": 0
}
]
}
]
}
]
}Hata kodları
Hatalarda gövde her zaman aynı biçimdedir: {"ok": false, "error": "..."}
| HTTP | error | Ne yapmalı |
|---|---|---|
| 200 | ok: true | İstek başarılı. Gövde menü verisini içerir. |
| 401 | Missing API key. | Anahtar gönderilmedi. X-API-Key başlığını ekleyin. |
| 403 | Invalid API key. | Anahtar yanlış ya da iptal edilmiş. Panelden yeni anahtar oluşturun. |
| 422 | restaurant parameter is required. | restaurant parametresi boş. |
| 404 | Restaurant not found. | Bu adrese sahip restoran yok, size ait değil ya da pasif. |
İstek limiti ve önbellek
Şu an sabit bir istek limiti uygulanmıyor. Yanıtlar önbelleğe alınmaz (Cache-Control: no-store), her istek güncel veriyi döndürür. Sitenizde yanıtı 1 ile 5 dakika arasında kendi tarafınızda saklamanızı öneririz; menü değişikliklerinin görünmesi için bu süre yeterlidir.
Örnek istekler
curl -s "https://mail.menuz.com.tr/api/public-menu.php?restaurant=lale-kahve" \
-H "X-API-Key: YOUR_API_KEY"<?php
$ch = curl_init('https://mail.menuz.com.tr/api/public-menu.php?restaurant=lale-kahve');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 10,
CURLOPT_HTTPHEADER => ['X-API-Key: ' . getenv('MENUZ_API_KEY')],
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$data = json_decode($body, true);
if ($status !== 200 || empty($data['ok'])) {
throw new RuntimeException($data['error'] ?? 'Menuz API error');
}
foreach ($data['menus'] as $menu) {
foreach ($menu['categories'] as $cat) {
foreach ($cat['items'] as $item) {
echo $item['name'], ': ', $item['price'], "\n";
}
}
}// Node.js 18+ (sunucu tarafı)
const res = await fetch('https://mail.menuz.com.tr/api/public-menu.php?restaurant=lale-kahve', {
headers: { 'X-API-Key': process.env.MENUZ_API_KEY },
});
const data = await res.json();
if (!res.ok || !data.ok) throw new Error(data.error);
for (const menu of data.menus) {
for (const cat of menu.categories) {
console.log(cat.name, cat.items.length);
}
}Güvenlik
- Anahtarı yalnızca sunucu tarafında kullanın. Tarayıcıda çalışan koda ya da mobil uygulama paketine koymayın.
- Anahtarı ortam değişkeninde (örneğin MENUZ_API_KEY) saklayın, kod deposuna eklemeyin.
- Anahtarın sızdığını düşünüyorsanız panelden yenileyin. Eski anahtar o anda çalışmayı bırakır.