MekanBook geliştirici platformu

Mekanınızın menüsünü, siparişlerini, rezervasyonlarını, sadakat hesaplarını ve etkinliklerini kendi yazılımınıza, muhasebe ve CRM sistemlerinize veya otomasyon araçlarına bağlayın.

Temel adres: https://www.mekanbook.com/api/partner/v1 · Sürüm 1.0.0

POS yazılımı geliştiriyorsanız (siparişleri POS'a aktarma, kasada ödeme) ayrıca POS Connector API.

Kimlik doğrulama

Mekan sahibi veya müdürü Panel › Ayarlar › Geliştirici sayfasından anahtar oluşturur. Anahtar yalnızca bir kez gösterilir; sunucumuzda yalnızca özeti saklanır. Her isteğe ekleyin:

Authorization: Bearer mbp_xxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

• Anahtarı istemci tarafı (tarayıcı, mobil uygulama) koduna koymayın; sunucunuzda ortam değişkeninde tutun.
• İsteğe bağlı IP izin listesi ve anahtar başına dakikalık istek sınırı (varsayılan 120) tanımlanabilir.
• Anahtarı yenilemek eskisini hemen geçersiz kılar. Tüm anahtar işlemleri denetim kaydına yazılır.

İzinler (scope)

KVKK: misafir listesi maskelidir (ad + soyadın baş harfi). Telefon ve e-posta yalnızca pazarlama izni veren misafirlerde ve kısmen gizli döner. Rezervasyon iletişim bilgisi yalnızca reservations kapsamında, mekanın kendi operasyonu için verilir.

Uç noktalar

Tutarlar kuruş cinsinden tamsayıdır (24500 = 245,00 TL). Zamanlar ISO 8601 (UTC). Fiyat değişiklikleri MekanBook fiyat geçmişine ve denetim kaydına yazılır; menü mevzuatı gereği fiyat güncelleme tarihi menüde gösterilir.

Örnekler

Bir ürünün fiyatını güncelleme

curl -X PATCH https://www.mekanbook.com/api/partner/v1/menu/items/123 \
  -H "Authorization: Bearer $MEKANBOOK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"price": 24500, "available": true}'

// Node 18+ (fetch yerleşik) — or: import { MekanBook } from '@mekanbook/partner'
const res = await fetch('https://www.mekanbook.com/api/partner/v1/menu/items/123', {
  method: 'PATCH',
  headers: { Authorization: `Bearer ${process.env.MEKANBOOK_API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({ price: 24500, available: true }),
});
if (!res.ok) throw new Error((await res.json()).error.message);
console.log((await res.json()).data);

import os, json, urllib.request

req = urllib.request.Request(
    "https://www.mekanbook.com/api/partner/v1/menu/items/123",
    data=json.dumps({"price": 24500, "available": True}).encode(),
    method="PATCH",
    headers={"Authorization": f"Bearer {os.environ['MEKANBOOK_API_KEY']}", "Content-Type": "application/json"},
)
print(json.load(urllib.request.urlopen(req))["data"])

<?php
$ch = curl_init('https://www.mekanbook.com/api/partner/v1/menu/items/123');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.getenv('MEKANBOOK_API_KEY'), 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['price' => 24500, 'available' => true]),
]);
$item = json_decode(curl_exec($ch), true)['data'];

Bugünkü rezervasyonlar

curl "https://www.mekanbook.com/api/partner/v1/reservations?from=2026-11-10T00:00&to=2026-11-10T23:59&status=confirmed" \
  -H "Authorization: Bearer $MEKANBOOK_API_KEY"

Rezervasyon oluşturma

curl -X POST https://www.mekanbook.com/api/partner/v1/reservations -H "Authorization: Bearer $MEKANBOOK_API_KEY" -H "Content-Type: application/json" \
  -d '{"date":"2026-11-11","time":"20:00","party":4,"name":"Ayşe Yılmaz","phone":"+905551112233"}'

API ile alınan rezervasyon personel girişi sayılır: doğrudan onaylanır, kapora istenmez; vardiya, kapasite ve kapalı gün kuralları geçerlidir.

Sayfalama, hatalar ve sınırlar

Listeler en yeniden eskiye sıralanır. limit (1–100, varsayılan 50) ve yanıttaki next_cursor değerini cursor parametresiyle gönderin; next_cursor null ise son sayfadasınız. Değişenleri çekmek için updated_since kullanın.

{ "data": [ … ], "next_cursor": "MTIzNA==" }

{ "error": { "code": "insufficient_scope", "message": "This API key lacks the 'orders:read' scope." } }

Webhook'lar

Panel › Geliştirici sayfasından veya webhooks:manage izniyle API'den https adresinizi ve olayları seçin. Her bildirim aynı biçimdedir:

POST /your/endpoint
X-MekanBook-Event: reservation.created
X-MekanBook-Delivery: 2b1f0c3e-…            ← tekrarları ayıklamak için kullanın
X-MekanBook-Timestamp: 1767225600
X-MekanBook-Signature: t=1767225600,v1=5f2c…

{"id":"2b1f0c3e-…","type":"reservation.created","created_at":"2026-12-31T19:00:00+00:00","venue_id":42,"data":{ … }}

Olaylar: order.created, order.updated, reservation.created, reservation.updated, reservation.cancelled, loyalty.earned, loyalty.redeemed, loyalty.adjusted, review.created, takeaway.created, takeaway.updated, menu.updated, ecommerce.link.created, ecommerce.link.revoked · ping (panelden deneme)

• 10 saniye içinde 2xx dönün; işi kuyruğa alıp hemen yanıtlayın.
• Başarısız teslimat 1 dk, 5 dk, 15 dk, 1 sa, 3 sa, 6 sa, 12 sa ve 24 sa sonra tekrar denenir. Art arda 50 başarısızlıkta uç nokta kapatılır; panelden yeniden açılabilir.
• Yalnızca herkese açık https adreslerine gönderilir (özel ağ ve yönlendirme izlenmez).

İmza doğrulama

İmza, ham (çözümlenmemiş) gövde ile hesaplanır: HMAC-SHA256(sır, "{t}.{gövde}"). Zaman damgası 5 dakikadan eskiyse reddedin.

import crypto from 'node:crypto';

export function verify(secret, header, rawBody) {
  const m = /t=(\d+),v1=([a-f0-9]{64})/.exec(header || '');
  if (!m || Math.abs(Date.now() / 1000 - Number(m[1])) > 300) return false;
  const expected = crypto.createHmac('sha256', secret).update(`${m[1]}.${rawBody}`).digest('hex');
  return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(m[2]));
}

import hmac, hashlib, re, time

def verify(secret: str, header: str, raw_body: bytes) -> bool:
    m = re.search(r"t=(\d+),v1=([a-f0-9]{64})", header or "")
    if not m or abs(time.time() - int(m.group(1))) > 300:
        return False
    expected = hmac.new(secret.encode(), m.group(1).encode() + b"." + raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, m.group(2))

<?php
function mekanbook_verify(string $secret, string $header, string $rawBody): bool {
    if (! preg_match('/t=(\d+),v1=([a-f0-9]{64})/', $header, $m) || abs(time() - (int) $m[1]) > 300) {
        return false;
    }
    return hash_equals(hash_hmac('sha256', $m[1].'.'.$rawBody, $secret), $m[2]);
}
// $ok = mekanbook_verify(getenv('MEKANBOOK_WEBHOOK_SECRET'), $_SERVER['HTTP_X_MEKANBOOK_SIGNATURE'] ?? '', file_get_contents('php://input'));

MCP sunucusu (yapay zekâ asistanları)

Model Context Protocol destekleyen asistanlar (ör. Claude, ChatGPT ve MCP uyumlu IDE'ler) mekan verinizi salt okunur sorgulayabilir: “Bu akşam kaç kişilik rezervasyon var?”, “Menüde 300 TL altındaki mezeler?”

@__raw_block_3__{{ $mcpUrl }}",
      "headers": { "Authorization": "Bearer mbp_…" }
    }
  }
}

Asistana yalnızca okuma izinli ayrı bir anahtar verin (ör. menu:read, reservations:read, events:read). Misafir verisi maskelidir.

SDK

import { MekanBook } from './mekanbook-js/src/index.js';
const mb = new MekanBook({ apiKey: process.env.MEKANBOOK_API_KEY });
for await (const r of mb.paginate('/reservations', { status: 'confirmed' })) console.log(r.starts_at, r.party_size);

E-ticaret sadakat

Mekanın online mağazası, mekandaki aynı sadakat kartında puan kazandırır ve kullandırır. Anahtar Panel › Pazarlama › Online mağaza bölümünde oluşur (ecommerce:read, ecommerce:write). Müşteri, hesabının bağlanmasını e-postasına gelen kodla kendisi onaylar; mağaza yalnızca opak bir customer_ref görür.

curl -X POST https://www.mekanbook.com/api/partner/v1/ecommerce/redemptions \
  -H "Authorization: Bearer mbp_…" -H "Idempotency-Key: cart-8f2c" -H "Content-Type: application/json" \
  -d '{"customer_ref":"mbc_…","order_total":45000,"unit":"points","points":300}'

Zapier · Make · n8n

Kod yazmadan bağlamak için: webhook tetikleyicisi olarak aracın verdiği adresi Panel › Geliştirici › Webhook ekle bölümüne yazın; işlem adımlarında “HTTP isteği” modülüyle API'yi Bearer anahtarıyla çağırın.

• Zapier: Webhooks by Zapier › Catch Hook (tetikleyici) → Google E-Tablolar, Slack, e-posta…
• Make: Webhooks › Custom webhook → HTTP › Make a request. Örnek senaryo: make-blueprint.json
• n8n: Webhook düğümü → (imza doğrulama için Code düğümü) → HTTP Request. Örnek iş akışı: n8n-workflow.json

Örnek dosyaları indir (Make, n8n, Zapier)

Sürüm notları

• 1.0.0 · 2026-11-26 — İlk sürüm: menü, sipariş, rezervasyon, sadakat, misafir, etkinlik uçları; webhook'lar; MCP sunucusu; JavaScript ve Python SDK.

Geriye uyumsuz değişiklikler yeni bir sürüm yolunda (/v2) yapılır; v1 en az 12 ay önceden duyurulmadan kapatılmaz. Yenilikler