İçindekiler

Belgeler

Lezzet35 API

İzmir yemek pazaryeri Lezzet35’in HTTP API’si. Üç bölge: herkese açık JSON uçları (sağlık, kimlik, bölge), SiparişMatik kasa uyumluluk katmanı /api/v1 (canlı) ve Partner API /api/v2 (Faz 6). Tüm tutarlar sunucuda hesaplanır; istemciden fiyat/indirim alanı kabul edilmez.

Sürüm:: 1.0.0
Uçlar:: 29 hazır · 8 planlandı
Makine biçimi:: /api/openapi.json

Hızlı başlangıç

Örneklerde $LEZZET35_URL sunucu kökünü temsil eder. Yanıt zarfı her JSON ucunda aynıdır: başarıda { success: true, data }, hatada { success: false, message, errors? }. Tüm tarih/saatler ISO 8601 (UTC); tutarlar kuruş; v1 katmanı WPSipariş biçimlerini (TL ondalık, dd.MM.yyyy HH:mm) korur.

bash

export LEZZET35_URL="http://localhost:3000"
curl "$LEZZET35_URL/api/health"

Rehberler: SiparişMatik kurulumu · Partner API v2 taslağı

Sağlık

Sağlık kontrolü ve belge keşfi (kimlik gerekmez)

get/api/healthHazır

Sağlık kontrolü

Coolify ve izleme araçları için sağlık ucu. Veritabanı ve Redis ayrı raporlanır; biri hatalıysa 503 döner. Bu uç standart {success, data} zarfını kullanmaz (izleme araçları düz alan bekler). Yanıt cache-control: no-store ile gelir; her bağımlılık kontrolü 2 sn zaman aşımlıdır.

Kimlik:: gerekmez

Yanıtlar

200Her iki bağımlılık sağlıklı

Alan	Tip	Zorunlu	Açıklama
durum	enum(ok \| sorunlu)	evet	İki bağımlılık da ok ise ok
db	enum(ok \| hata)	evet
redis	enum(ok \| hata)	evet
surum	string	evet	package.json sürümü
zaman	string (date-time)	evet	Sunucu saati (ISO 8601, UTC)

Örnek 200

{
  "durum": "ok",
  "db": "ok",
  "redis": "ok",
  "surum": "0.1.0",
  "zaman": "2026-09-16T09:00:00.000Z"
}

503db ya da redis hatalı; gövde aynı şekil, durum: sorunlu

Örnek 503

{
  "durum": "sorunlu",
  "db": "ok",
  "redis": "hata",
  "surum": "0.1.0",
  "zaman": "2026-09-16T09:00:00.000Z"
}

curl

curl -X GET "$LEZZET35_URL/api/health"

Kaynak: src/app/api/health/route.ts

get/api/openapi.jsonHazır

OpenAPI belgesi

Bu belgenin makine biçimi (OpenAPI 3.1). 5 dakika önbelleklenir (cache-control: public, max-age=300). Kod üretimi ve sözleşme testleri bu ucu kullanır.

Kimlik:: gerekmez

Yanıtlar

200OpenAPI 3.1 belgesi

Alan	Tip	Zorunlu	Açıklama
(gövde)	nesne	evet	OpenAPI 3.1.0 belgesi; `openapi`, `info`, `paths`, `components` anahtarları

curl

curl -X GET "$LEZZET35_URL/api/openapi.json"

Kaynak: src/app/api/openapi.json/route.ts

Kimlik

OTP ile giriş/kayıt (D1). Şifre yok; oturum HttpOnly çerez

post/api/auth/otp/istekHazır

OTP kodu iste

Telefona 6 haneli tek kullanımlık kod gönderir (SMS: MasGSM; geliştirmede konsol). Kod düz metin saklanmaz, sha256 özeti 5 dk geçerlidir ve 5 deneme hakkı vardır. Aynı numara için OTP_BEKLEME_SN (60 sn) dolmadan yeni istek 429 döner. Üye olmayan numara doğrulamada otomatik kaydedilir (şifre yok).

Kimlik:: gerekmez
Hız sınırı:: Telefon başına 3 / 10 dk (`OTP_TEL_LIMIT`), IP başına 21 / 10 dk; ardışık istek 60 sn bekleme

İstek gövdesi (application/json)

Alan	Tip	Zorunlu	Açıklama
telefon	string	evet	Türkiye cep telefonu; 05xx, 5xx ya da +905xx biçimleri kabul edilir, sunucu E.164’e çevirir
amac	enum(giris \| kayit \| panel-token)	hayır	Kodun amacı; varsayılan giris

Yanıtlar

200Kod gönderildi

Alan	Tip	Zorunlu	Açıklama
success	= true	evet	Her zaman true
data	nesne	evet
data.gonderildi	= true	evet
data.bitisSn	integer	evet	Kodun geçerlilik süresi (saniye)

Örnek 200

{
  "success": true,
  "data": {
    "gonderildi": true,
    "bitisSn": 300
  }
}

400Doğrulama hatası (alan bazlı errors) ya da geçersiz Türkiye numarası

Örnek 400

{
  "success": false,
  "message": "Geçerli bir Türkiye cep telefonu numarası girin",
  "errors": {
    "telefon": [
      "biçim"
    ]
  }
}

429Hız sınırı aşıldı; retry-after başlığı ve yenidenSn alanı kaç saniye sonra denenebileceğini söyler

Örnek 429

{
  "success": false,
  "message": "Çok fazla istek; lütfen biraz sonra tekrar deneyin",
  "yenidenSn": 412
}

500Beklenmeyen sunucu hatası; ayrıntı yalnız sunucu logunda

Örnek 500

{
  "success": false,
  "message": "Sunucu hatası"
}

curl

curl -X POST "$LEZZET35_URL/api/auth/otp/istek" \
  -H "Content-Type: application/json" \
  -d '{"telefon":"0532 123 45 67","amac":"giris"}'

Kaynak: src/app/api/auth/otp/istek/route.ts

post/api/auth/otp/dogrulaHazır

OTP kodunu doğrula

Kodu doğrular; başarılıysa kullanıcı kimliğini döner ve numara ilk kez doğrulanıyorsa hesabı oluşturur. Oturum çerezi bu uçta açılmaz: tarayıcı akışı /giris sayfasındaki Server Action ile HttpOnly l35_oturum çerezi açar. Mobil/PWA için token tabanlı oturum ucu Faz 5’te (D1). Hatalı kod neden alanıyla ayrıştırılır: bulunamadi | suresi_doldu | deneme_asildi | yanlis.

Kimlik:: gerekmez
Hız sınırı:: Telefon başına 10 / 10 dk

İstek gövdesi (application/json)

Alan	Tip	Zorunlu	Açıklama
telefon	string	evet	Türkiye cep telefonu; 05xx, 5xx ya da +905xx biçimleri kabul edilir, sunucu E.164’e çevirir
kod	string /^\d{6}$/	evet	SMS ile gelen 6 haneli kod

Yanıtlar

200Kod doğru

Alan	Tip	Zorunlu	Açıklama
success	= true	evet	Her zaman true
data	nesne	evet
data.userId	string	evet	Kullanıcı kimliği (cuid)
data.yeniKullanici	boolean	evet	Numara ilk kez doğrulandıysa true (otomatik kayıt)

Örnek 200

{
  "success": true,
  "data": {
    "userId": "cmfl3k9x40000abcd1234efgh",
    "yeniKullanici": false
  }
}

400Doğrulama hatası, geçersiz numara ya da yanlış/süresi dolmuş kod (neden)

Örnek 400

{
  "success": false,
  "message": "Kod hatalı",
  "neden": "yanlis"
}

429Hız sınırı aşıldı; retry-after başlığı ve yenidenSn alanı kaç saniye sonra denenebileceğini söyler

Örnek 429

{
  "success": false,
  "message": "Çok fazla istek; lütfen biraz sonra tekrar deneyin",
  "yenidenSn": 412
}

500Beklenmeyen sunucu hatası; ayrıntı yalnız sunucu logunda

Örnek 500

{
  "success": false,
  "message": "Sunucu hatası"
}

curl

curl -X POST "$LEZZET35_URL/api/auth/otp/dogrula" \
  -H "Content-Type: application/json" \
  -d '{"telefon":"0532 123 45 67","kod":"123456"}'

Kaynak: src/app/api/auth/otp/dogrula/route.ts

Bölge

İzmir ilçe/mahalle ve servis alanı (M04)

get/api/bolge/mahalle-araHazır

Mahalle ara

İzmir mahallelerinde arama (adres formu ve vitrin konum seçici için). Önek eşleşmesi önce, sonra trigram benzerliği (pg_trgm, eşik 0,3); Türkçe karakterden bağımsız (alsan → Alsancak). En fazla 8 sonuç; 2 karakterden kısa sorgu boş liste döner. Yanıt 60 sn herkese açık önbelleklenir. Bu uç ilçe filtresi almaz; istemci ilceId alanına göre sıralar.

Kimlik:: gerekmez
Hız sınırı:: IP başına 60 / dk

Parametreler

Ad	Konum	Zorunlu	Tip	Açıklama
q	query	hayır	string	Arama metni (en az 2 karakter; 60 karakterden sonrası kırpılır) Örnek: alsan

Yanıtlar

200Eşleşen mahalleler (boş dizi olabilir)

Alan	Tip	Zorunlu	Açıklama
success	= true	evet	Her zaman true
data	dizi<MahalleSonucu>	evet	En fazla 8 sonuç; önek eşleşmesi önce
data[].id	integer	evet	Mahalle kimliği (kaynak veri mahalle_id)
data[].ad	string	evet	Başlık biçiminde ad
data[].ilceId	integer	evet
data[].ilceAd	string	evet

Örnek 200

{
  "success": true,
  "data": [
    {
      "id": 61033,
      "ad": "Alsancak Mahallesi",
      "ilceId": 3513,
      "ilceAd": "Konak"
    }
  ]
}

429Hız sınırı aşıldı; retry-after başlığı ve yenidenSn alanı kaç saniye sonra denenebileceğini söyler

Örnek 429

{
  "success": false,
  "message": "Çok fazla istek; lütfen biraz sonra tekrar deneyin",
  "yenidenSn": 412
}

500Beklenmeyen sunucu hatası; ayrıntı yalnız sunucu logunda

Örnek 500

{
  "success": false,
  "message": "Sunucu hatası"
}

curl

curl -X GET "$LEZZET35_URL/api/bolge/mahalle-ara?q=alsan"

Kaynak: src/app/api/bolge/mahalle-ara/route.ts · modules/M04-bolge/servis-alani.ts mahalleAra

SiparişMatik v1 (iki sistem: WhatsApp/markalı site · Pazaryeri)

SiparişMatik kasa uyumluluk katmanı — yollar ve alanlar WPSipariş ile birebir (Faz 6, canlı); entegrasyon belgesi docs/api/siparismatik.md

get/api/v1/poolHazır

Havuz: bağlantıya hazır firmalar

Exe açılışta yerelde Lezzet35 kaydı yoksa çağırır; havuz[] içinde siparismatik_id eşleşen firmanın api_token’ını alır. Lezzet35’te HAZIR penceresi (KARAR-9): admin "bağlantıya hazırla" der → firma POOL_HAZIR_PENCERE_SAAT (24 sa) boyunca havuzda görünür → PUT /pool/connect ile BAGLI olur ya da süre dolunca düşer. WPSipariş’in "tüm HAZIR firmaların token’ı döner" davranışı böyle daraltılır; exe değişmez.

Kimlik:: X-Pool-Secret
Hız sınırı:: IP başına 30 / dk

Yanıtlar

200v1 zarfı: success JSON boolean, message; veri anahtarları alan tablosunda

Alan	Tip	Zorunlu	Açıklama
success	boolean	evet
message	string	hayır

401Kimlik başlığı eksik/yanlış: {success:false, message}

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu	Açıklama
success	boolean	evet	JSON boolean; exe "True" metniyle karşılaştırır
message	string	hayır	Bilgi mesajı
havuz[].id	integer	evet	Firma kimliği (Firma.v1Id); exe `pool` seçiminde kullanır
havuz[].domain_id	integer	hayır	Ana marka kimliği
havuz[].siparismatik_id	integer	evet	SiparişMatik firmaid; exe Registry("firmaid") ile eşler
havuz[].ad	string	evet	Firma adı
havuz[].subdomain	string	evet	Marka slug’ı (eski alt alan adı)
havuz[].baglanti_durumu	string	evet	Her zaman HAZIR (pencere içindeki firmalar)
havuz[].api_token	string	evet	Firma Bearer anahtarı — yalnız HAZIR penceresinde döner (KARAR-9)
toplam	integer	hayır	Listedeki firma sayısı

curl

curl -X GET "$LEZZET35_URL/api/v1/pool" \
  -H "X-Pool-Secret: $POOL_SECRET_KEY"

Kaynak: wpsiparis-api-contract.md §4.1 · Entegrasyon.cs:7905-7921

put/api/v1/pool/connectHazır

Havuz: bağlan

Gövde yok. Firma BAGLI olur, havuzdan düşer; firma.* alanları exe’nin entegrasyon kaydına yazılır. Token rotasyonu bu uçta mümkün değil (exe token’ı değiştirmez).

Kimlik:: Bearer (firma anahtarı)

Yanıtlar

200v1 zarfı: success JSON boolean, message; veri anahtarları alan tablosunda

Alan	Tip	Zorunlu	Açıklama
success	boolean	evet
message	string	hayır

401Kimlik başlığı eksik/yanlış: {success:false, message}

404Firma/kayıt yok ya da başka firmaya ait (varlık sızdırmaz)

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu	Açıklama
success	boolean	evet
firma.id	integer	evet	Firma kimliği
firma.domain_id	integer	evet	Ana şube kimliği; exe ana entegrasyon kaydına yazar
firma.ad	string	evet
firma.subdomain	string	evet
firma.baglanti_durumu	string	evet	connect → BAGLI, disconnect → HAZIR
firma.baglanti_zamani	string	evet	dd.MM.yyyy HH:mm
firma.baglanti	string	evet	ONLINE \| OFFLINE

curl

curl -X PUT "$LEZZET35_URL/api/v1/pool/connect" \
  -H "Authorization: Bearer $FIRMA_API_ANAHTARI"

Kaynak: §4.2 · Entegrasyon.cs:7945-7961

put/api/v1/pool/disconnectHazır

Havuz: bağlantıyı kopar

Exe çağırmaz; admin "bağlantıyı kopar" ile aynı işlev. Firma yeniden HAZIR olur ve pencere baştan başlar.

Kimlik:: Bearer (firma anahtarı)

Yanıtlar

200v1 zarfı: success JSON boolean, message; veri anahtarları alan tablosunda

Alan	Tip	Zorunlu	Açıklama
success	boolean	evet
message	string	hayır

401Kimlik başlığı eksik/yanlış: {success:false, message}

404Firma/kayıt yok ya da başka firmaya ait (varlık sızdırmaz)

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu	Açıklama
success	boolean	evet
firma.id	integer	evet	Firma kimliği
firma.ad	string	evet
firma.baglanti_durumu	string	evet	connect → BAGLI, disconnect → HAZIR
firma.baglanti	string	evet	ONLINE \| OFFLINE

curl

curl -X PUT "$LEZZET35_URL/api/v1/pool/disconnect" \
  -H "Authorization: Bearer $FIRMA_API_ANAHTARI"

Kaynak: §4.2 · PoolController.php:194-230

post/api/v1/pool/categories/syncHazır

Kategori senkronu (exe → Lezzet35)

Kodda var, zamanlanmamış (Form_KasaService.cs:1207 yorumda). Yeni kategori PASIF olarak eklenir ve moderasyon kuyruğuna düşer; sp_kategori_id eşleşende yalnız ad güncellenir; silme yok. İdempotent: (firma, sp_kategori_id) tekil.

Kimlik:: Bearer (firma anahtarı)

İstek gövdesi (application/json)

Alan	Tip	Zorunlu
categories	dizi<nesne>	evet
categories[].sp_kategori_id	string	hayır
categories[].ad	string	evet
categories[].sira	integer	hayır
categories[].aciklama	string	hayır
categories[].durum	enum(AKTIF \| PASIF)	hayır

Yanıtlar

200v1 zarfı: success JSON boolean, message; veri anahtarları alan tablosunda

Alan	Tip	Zorunlu	Açıklama
success	boolean	evet
message	string	hayır

401Kimlik başlığı eksik/yanlış: {success:false, message}

422Doğrulama hatası: {success:false, message:"Doğrulama hatası: …"}

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu	Açıklama
categories[].sp_kategori_id	string	evet	Kasa kategori kimliği (eşleme anahtarı)
categories[].ad	string	evet	ASCIITemizle uygulanmış ad
categories[].sira	integer	evet
categories[].aciklama	string	evet
categories[].durum	AKTIF \| PASIF	hayır
success	boolean	evet
message	string	evet	Exe ürün senkronunda okur
summary.created	integer	hayır
summary.updated	integer	hayır
summary.skipped	integer	hayır	İdempotent tekrar → skipped artar
summary.total	integer	hayır

curl

curl -X POST "$LEZZET35_URL/api/v1/pool/categories/sync" \
  -H "Authorization: Bearer $FIRMA_API_ANAHTARI" \
  -H "Content-Type: application/json" \
  -d '{"categories":[{"sp_kategori_id":"12","ad":"Kumrular","sira":1,"aciklama":""}]}'

Kaynak: §4.2 · PoolController.php:305-406 · Entegrasyon.cs:8094-8128

post/api/v1/pool/products/syncHazır

Ürün senkronu (exe/Pro → Lezzet35)

10 sn’de bir, yalnız guncelle='Y' ürünler. Exe bayrağı yanıt gelmeden temizler (Entegrasyon.cs:8233) → ağ hatasında güncelleme kaybolur; telafi: admin "tam senkron iste" komutu ve Faz 6 v2 webhook. Yeni ürün PASIF eklenir; sp_urun_id eşleşende ad/fiyat/varyant güncellenir ve restoran panelinde "SiparişMatik’ten geldi" etiketiyle görünür. urunweb='N' → PASIF; çarpan tipi varyantta fiyat = urun_fiyat × carpan.

Kimlik:: Bearer (firma anahtarı)
Hız sınırı:: Token başına 120 / dk (tüm firma uçları ortak)

İstek gövdesi (application/json)

Alan	Tip	Zorunlu
products	dizi<nesne>	evet
products[].sp_urun_id	string	hayır
products[].sp_kategori_id	string	hayır
products[].kategori_ad	string	hayır
products[].ad	string	evet
products[].fiyat	number	evet
products[].aciklama	string	hayır
products[].sira	integer	hayır
products[].durum	enum(AKTIF \| PASIF)	hayır
products[].kdv	enum(0 \| 1 \| 10 \| 20)	hayır
products[].ekstralar	dizi<nesne>	hayır
products[].ekstralar[].ad	string	hayır
products[].ekstralar[].fiyat	number	hayır
products[].foto_url	string	hayır
products[].salon_fiyat	number	hayır
products[].alerjenler	dizi<string>	hayır
products[].etiketler	dizi<string>	hayır
products[].silindi	boolean	hayır
products[].guncellendi_at	string (date-time)	hayır
products[].varyantlar	dizi<nesne>	hayır
products[].varyantlar[].ad	string	evet
products[].varyantlar[].fiyat	number	evet

Yanıtlar

200v1 zarfı: success JSON boolean, message; veri anahtarları alan tablosunda

Alan	Tip	Zorunlu	Açıklama
success	boolean	evet
message	string	hayır

401Kimlik başlığı eksik/yanlış: {success:false, message}

422Doğrulama hatası: {success:false, message:"Doğrulama hatası: …"}

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu	Açıklama
products[].sp_urun_id	string	evet	Kasa ürün kimliği (eşleme anahtarı)
products[].sp_kategori_id	string	evet
products[].kategori_ad	string	evet
products[].ad	string	evet
products[].fiyat	number	evet	TL, ondalık
products[].aciklama	string	evet
products[].sira	integer	evet
products[].durum	AKTIF \| PASIF	evet	`urunweb='N'` → PASIF
products[].varyantlar[].ad	string	evet
products[].varyantlar[].fiyat	number	evet	Çarpanlı varyantta hesaplanmış fiyat
products[].kdv	0 \| 1 \| 10 \| 20	hayır	Pro ek alanı (sözleşme §1.2)
products[].ekstralar[]	{ad, fiyat}[]	hayır	Pro ek alanı; tek grup "Ekstralar", ek ücret
products[].foto_url	string	hayır	Yalnız Lezzet35 yükleme adresi (`…/foto` ucu)
products[].salon_fiyat	number	hayır	Masa (xQR) fiyatı TL (K-44 §4); verilmezse değişmez, null → paket fiyatı
products[].alerjenler	string[]	hayır	14 yönetmelik kodu (bilinmeyen kod → 422): gluten, kabuklu_deniz, yumurta, balik, fistik, soya, sut, kabuklu_yemis, kereviz, hardal, susam, sulfit, aci_bakla, yumusakca
products[].etiketler	string[]	hayır	vejetaryen, vegan, glutensiz, laktozsuz, helal, aci (bilinmeyen → 422)
products[].silindi	boolean	hayır	true → PASIF (silinmez)
products[].guncellendi_at	date-time	hayır	Çakışma kuralı: Lezzet35 updatedAt'ten eskiyse satır uygulanmaz
success	boolean	evet
message	string	evet	Exe ürün senkronunda okur
summary.created	integer	hayır
summary.updated	integer	hayır
summary.skipped	integer	hayır	İdempotent tekrar → skipped artar
summary.total	integer	hayır
errors[]	string[]	hayır	Satır bazlı hata mesajları
conflicts[]	string[]	hayır	Çakışma nedeniyle atlanan sp_urun_id'ler (Pro)

curl

curl -X POST "$LEZZET35_URL/api/v1/pool/products/sync" \
  -H "Authorization: Bearer $FIRMA_API_ANAHTARI" \
  -H "Content-Type: application/json" \
  -d '{"products":[{"sp_urun_id":"1001","sp_kategori_id":"12","kategori_ad":"Kumrular","ad":"Klasik Kumru","fiyat":120,"aciklama":"","sira":1,"durum":"AKTIF","varyantlar":[{"ad":"Büyük","fiyat":145}]}]}'

Kaynak: §4.2 · PoolController.php:415-584 · Entegrasyon.cs:8163-8243

post/api/v1/pool/products/{sp_urun_id}/fotoHazır

Ürün görseli (Pro → Lezzet35)

SiparişMatik Pro menü senkronu (docs/pro-menu-senkron-sozlesmesi.md §1.3): multipart dosya (JPEG/PNG/WebP, ≤ 3 MB) → WebP ≤ 1200 px; ürün sp_urun_id ile bulunur (önce products/sync). Yanıt data.foto_url mutlak adres.

Kimlik:: Bearer (firma anahtarı)
Hız sınırı:: Firma başına 30 / dk

Parametreler

Ad	Konum	Zorunlu	Tip	Açıklama
sp_urun_id	path	evet	string	Pro ürün kimliği (metin; sayı da kabul) Örnek: 41

Yanıtlar

200v1 zarfı: success JSON boolean, message; veri anahtarları alan tablosunda

Alan	Tip	Zorunlu	Açıklama
success	boolean	evet
message	string	hayır

401Kimlik başlığı eksik/yanlış: {success:false, message}

404Ürün yok (önce products/sync)

422Doğrulama hatası: {success:false, message:"Doğrulama hatası: …"}

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu	Açıklama
dosya	file	evet	multipart
success	boolean	evet
data.foto_url	string	evet	Mutlak adres; products/sync `foto_url` olarak geri gönderilebilir

curl

curl -X POST "$LEZZET35_URL/api/v1/pool/products/41/foto" \
  -H "Authorization: Bearer $FIRMA_API_ANAHTARI"

Kaynak: Pro sözleşmesi §1.3

post/api/v1/pool/sms/logHazır

SMS kazanım logu (api.siparismatik.net → Lezzet35)

Exe değil, SiparişMatik merkez sunucusu çağırır (function.php:522-560 Lezzet35_SMSLog): içinde Lezzet35 adresi geçen SMS’lerin adedini raporlar. İdempotency: siparismatik_id + tarih + tip + adet + aciklama özeti; aynı kayıt iki kez sayılmaz (M08/M13 raporu).

Kimlik:: X-Pool-Secret

İstek gövdesi (application/json)

Alan	Tip	Zorunlu
siparismatik_id	integer	evet
sms_logs	dizi<nesne>	evet
sms_logs[].tarih	string (date)	evet
sms_logs[].tip	enum(tek \| toplu)	evet
sms_logs[].adet	integer	evet
sms_logs[].aciklama	string	hayır

Yanıtlar

200v1 zarfı: success JSON boolean, message; veri anahtarları alan tablosunda

Alan	Tip	Zorunlu	Açıklama
success	boolean	evet
message	string	hayır

401Kimlik başlığı eksik/yanlış: {success:false, message}

404Firma/kayıt yok ya da başka firmaya ait (varlık sızdırmaz)

422Doğrulama hatası: {success:false, message:"Doğrulama hatası: …"}

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu	Açıklama
siparismatik_id	integer	evet
sms_logs[].tarih	date	evet
sms_logs[].tip	tek \| toplu	evet
sms_logs[].adet	integer ≥ 1	evet
sms_logs[].aciklama	string	hayır
data.firma_id	integer	hayır
data.firma_ad	string	hayır
data.kaydedilen	integer	hayır	Bu çağrıda kaydedilen satır sayısı

curl

curl -X POST "$LEZZET35_URL/api/v1/pool/sms/log" \
  -H "X-Pool-Secret: $POOL_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"siparismatik_id":9001,"sms_logs":[{"tarih":"2026-09-16","tip":"toplu","adet":120,"aciklama":"Kampanya"}]}'

Kaynak: §4.1 · PoolController.php:766-825

get/api/v1/Hazır

Keşif ucu

Firma özeti ve uç listesi (restaurant, endpoints). Exe çağırmaz; zararsız keşif.

Kimlik:: Bearer (firma anahtarı)

Yanıtlar

200v1 zarfı: success JSON boolean, message; veri anahtarları alan tablosunda

Alan	Tip	Zorunlu	Açıklama
success	boolean	evet
message	string	hayır

401Kimlik başlığı eksik/yanlış: {success:false, message}

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu	Açıklama
restaurant.id	integer	hayır
restaurant.name	string	hayır
restaurant.subdomain	string	hayır
restaurant.online_aktif	boolean	hayır
restaurant.status	string	hayır
restaurant.markalar[]	object[]	hayır
endpoints	object	hayır	Uç adı → yol

curl

curl -X GET "$LEZZET35_URL/api/v1/" \
  -H "Authorization: Bearer $FIRMA_API_ANAHTARI"

Kaynak: §4.3 · ApiController.php:17-57

get/api/v1/statusHazır

Firma durumu

Firma ve markaların açık/kapalı durumu.

Kimlik:: Bearer (firma anahtarı)

Yanıtlar

200v1 zarfı: success JSON boolean, message; veri anahtarları alan tablosunda

Alan	Tip	Zorunlu	Açıklama
success	boolean	evet
message	string	hayır

401Kimlik başlığı eksik/yanlış: {success:false, message}

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu
data.id	integer	hayır
data.name	string	hayır
data.online_aktif	boolean	hayır
data.status	string	hayır
data.url	string	hayır
data.markalar[].id	integer	hayır
data.markalar[].marka_adi	string	hayır
data.markalar[].aktif	boolean	hayır
data.markalar[].status	string	hayır

curl

curl -X GET "$LEZZET35_URL/api/v1/status" \
  -H "Authorization: Bearer $FIRMA_API_ANAHTARI"

Kaynak: §4.3 · ApiController.php:62-99

post/api/v1/statusHazır

Firmayı aç/kapat

Exe’de yorumda (8051). Lezzet35’te firmanın tüm şubelerini açar/kapatır (WPSipariş yalnız online_aktif bayrağını değiştiriyordu, vitrinde etkisizdi).

Kimlik:: Bearer (firma anahtarı)

İstek gövdesi (application/json)

Alan	Tip	Zorunlu	Açıklama
status	enum(online \| offline)	evet

Yanıtlar

200v1 zarfı: success JSON boolean, message; veri anahtarları alan tablosunda

Alan	Tip	Zorunlu	Açıklama
success	boolean	evet
message	string	hayır

401Kimlik başlığı eksik/yanlış: {success:false, message}

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu	Açıklama
status	online \| offline	evet	İstek

curl

curl -X POST "$LEZZET35_URL/api/v1/status" \
  -H "Authorization: Bearer $FIRMA_API_ANAHTARI" \
  -H "Content-Type: application/json" \
  -d '{"status":"online"}'

Kaynak: §4.3 · ApiController.php:104-131

get/api/v1/branchesHazır

Şubeler (alt markalar)

Ana şube hariç şubeler; exe her satır için ayrı entegrasyon kaydı açar (entegrasyonresid = data[].id). Ana şube connect.firma.domain_id ile ayrıca kaydedilir — Lezzet35 aynı ayrımı korur.

Kimlik:: Bearer (firma anahtarı)

Yanıtlar

200v1 zarfı: success JSON boolean, message; veri anahtarları alan tablosunda

Alan	Tip	Zorunlu	Açıklama
success	boolean	evet
message	string	hayır

401Kimlik başlığı eksik/yanlış: {success:false, message}

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu	Açıklama
success	boolean	evet
data[].id	integer	evet	Şube kimliği
data[].marka_adi	string	evet
data[].subdomain	string	evet
data[].url	string	evet	Vitrin adresi
data[].aktif	boolean	evet
data[].status	string	hayır

curl

curl -X GET "$LEZZET35_URL/api/v1/branches" \
  -H "Authorization: Bearer $FIRMA_API_ANAHTARI"

Kaynak: §4.3 · ApiController.php:136-160 · Entegrasyon.cs:7990-8009

post/api/v1/branches/{id}/statusHazır

Şubeyi aç/kapat

10 sn’de bir, yalnız yerel durum değişince. Kiracı sınırı: token firması ≠ şube firması → 403. Yanıttaki data.online_aktif gönderilenle eşitse exe yerel durumu günceller.

Kimlik:: Bearer (firma anahtarı)

Parametreler

Ad	Konum	Zorunlu	Tip	Açıklama
id	path	evet	integer	Şube kimliği (`branches` → `data[].id`; ana şube kimliği de kabul) Örnek: 1042

İstek gövdesi (application/json)

Alan	Tip	Zorunlu	Açıklama
status	enum(online \| offline)	evet

Yanıtlar

200v1 zarfı: success JSON boolean, message; veri anahtarları alan tablosunda

Alan	Tip	Zorunlu	Açıklama
success	boolean	evet
message	string	hayır

401Kimlik başlığı eksik/yanlış: {success:false, message}

403Başka firmanın şubesi

404Şube yok

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu	Açıklama
status	online \| offline	evet	İstek
success	boolean	evet
data.domain_id	integer	hayır
data.marka_adi	string	hayır
data.online_aktif	boolean	evet	Exe "True" karşılaştırması
data.ana_marka	boolean	hayır

curl

curl -X POST "$LEZZET35_URL/api/v1/branches/1042/status" \
  -H "Authorization: Bearer $FIRMA_API_ANAHTARI" \
  -H "Content-Type: application/json" \
  -d '{"status":"offline"}'

Kaynak: §4.3 · ApiController.php:165-249 · Entegrasyon.cs:8046-8072

get/api/v1/menuHazır

Menü aynası (Lezzet35 → exe)

Açılışta bir kez. Kategori ve ürünler kasaya aynalanır; exe urun.kategori.id == kategori.id ile eşler, siparismatik_id alanlarıyla yerel tablolara bağlar. `marka` nesnesi asla null dönmez (exe null kontrolsüz okur: Entegrasyon.cs:8508, 8521).

Kimlik:: Bearer (firma anahtarı)

Parametreler

Ad	Konum	Zorunlu	Tip	Açıklama
since	query	hayır	string	ISO-8601 UTC; verilirse yalnız `updatedAt >= since` kayıtlar (silinmişler `silindi:true`). Pro artımlı çekme; bir sonraki değer `summary.sunucu_zamani`

Yanıtlar

200v1 zarfı: success JSON boolean, message; veri anahtarları alan tablosunda

Alan	Tip	Zorunlu	Açıklama
success	boolean	evet
message	string	hayır

401Kimlik başlığı eksik/yanlış: {success:false, message}

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu	Açıklama
success	boolean	evet
data.firma.id	integer	evet
data.firma.ad	string	evet
data.firma.siparismatik_id	integer	evet
data.markalar[]	object[]	evet	`{id, ad, subdomain, ana_marka, aktif}`
data.kategoriler[].id	integer	evet
data.kategoriler[].siparismatik_id	string	evet	Kasa kategori kimliği (eşleme)
data.kategoriler[].ad	string	evet
data.kategoriler[].sira	integer	evet
data.kategoriler[].durum	string	hayır
data.kategoriler[].marka.id	integer	evet	Asla null
data.kategoriler[].marka.ad	string	hayır
data.urunler[].id	integer	evet
data.urunler[].siparismatik_id	string	evet
data.urunler[].ad	string	evet
data.urunler[].kategori.id	integer	evet	Kategori eşleme anahtarı
data.urunler[].fiyat	number	evet
data.urunler[].indirimli_fiyat	number \| null	hayır
data.urunler[].aciklama	string	evet
data.urunler[].foto	string \| null	hayır
data.urunler[].sira	integer	hayır
data.urunler[].durum	string	hayır
data.urunler[].varyantlar[]	object[]	hayır	`{ad, fiyat}` mutlak fiyat
data.urunler[].ekstralar[]	object[]	hayır	`{ad, fiyat}` ek ücret (Pro)
data.urunler[].kdv	integer	hayır	Pro
data.urunler[].guncellendi_at	date-time	hayır	UTC ISO (Pro çakışma kuralı)
data.urunler[].salon_fiyat	number \| null	hayır	Masa (xQR) fiyatı TL; null → paket fiyatı (K-44 §4)
data.urunler[].alerjenler	string[]	hayır	14 yönetmelik kodu: gluten, kabuklu_deniz, yumurta, balik, fistik, soya, sut, kabuklu_yemis, kereviz, hardal, susam, sulfit, aci_bakla, yumusakca
data.urunler[].etiketler	string[]	hayır	vejetaryen, vegan, glutensiz, laktozsuz, helal, aci
data.urunler[].silindi	boolean	hayır	Yalnız `since` ile gelebilir
data.urunler[].marka.id	integer	evet	Asla null
summary	object	hayır	Sayımlar + `sunucu_zamani` (bir sonraki `since`) + `since`

curl

curl -X GET "$LEZZET35_URL/api/v1/menu" \
  -H "Authorization: Bearer $FIRMA_API_ANAHTARI"

Kaynak: §4.3 · MenuController.php:20-128 · Entegrasyon.cs:8490-8531

get/api/v1/iptal-nedenleriHazır

İptal/ret nedenleri (v2.0)

Admin'in yönettiği hazır neden listesi; exe/köprü kodları gömmez, açılışta ve günde bir çeker. PUT …/durum gövdesinde iptal_nedeni olarak gönderilir. Her iki akışta aynı liste.

Kimlik:: Bearer (firma anahtarı)

Yanıtlar

200Liste

Alan	Tip	Zorunlu
success	boolean	hayır
data	dizi<nesne>	hayır
data[].kod	string	hayır
data[].metin	string	hayır
data[].aciklama_zorunlu	boolean	hayır

Örnek 200

{
  "success": true,
  "message": "İptal nedenleri",
  "data": [
    {
      "kod": "URUN_YOK",
      "metin": "Ürün / malzeme kalmadı",
      "aciklama_zorunlu": false
    },
    {
      "kod": "DIGER",
      "metin": "Diğer",
      "aciklama_zorunlu": true
    }
  ]
}

401Kimlik başlığı eksik/yanlış: {success:false, message}

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu	Açıklama
kod	string	evet	Sabit kod
metin	string	evet	Müşteriye gösterilen metin (admin düzenler)
aciklama_zorunlu	boolean	evet	true ise `durum_aciklama` zorunlu

curl

curl -X GET "$LEZZET35_URL/api/v1/iptal-nedenleri" \
  -H "Authorization: Bearer $FIRMA_API_ANAHTARI"

Kaynak: sözleşme v2.0 §3

get/api/v1/firma/siparislerHazır

Aktif siparişler (exe 10 sn’de bir çeker)

Exe parametresiz çağırır ve yalnız ilk sayfayı işler. WPSipariş 20’lik sayfalıyordu → 21. sipariş kayboluyordu. Lezzet35: parametresiz çağrıda günün tüm aktif siparişleri tek yanıtta (meta.last_page = 1); durum not in (TESLIM_EDILDI, IPTAL, REDDEDILDI). Exe siparis_no ile tekilleştirir (websiparisid), marka.id ile hangi entegrasyon kaydına düşeceğini bulur.

Kimlik:: Bearer (firma anahtarı)
Hız sınırı:: Token başına 120 / dk (exe 10 sn’de ≤ 4 çağrı yapar)

Parametreler

Ad	Konum	Zorunlu	Tip	Açıklama
durum	query	hayır	string (BEKLEMEDE \| ONAYLANDI \| HAZIRLANIYOR \| YOLDA \| TESLIM_EDILDI \| IPTAL \| REDDEDILDI)	v1 durum filtresi; exe göndermez
tarih_baslangic	query	hayır	string	YYYY-MM-DD
tarih_bitis	query	hayır	string	YYYY-MM-DD
per_page	query	hayır	integer	Yalnız parametreli çağrıda; varsayılan 20
page	query	hayır	integer

Yanıtlar

200v1 zarfı: success JSON boolean, message; veri anahtarları alan tablosunda

Alan	Tip	Zorunlu	Açıklama
success	boolean	evet
message	string	hayır

401Kimlik başlığı eksik/yanlış: {success:false, message}

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu	Açıklama
success	boolean	evet
data[].id	integer	evet	Sipariş v1Id; exe `messageid` — durum güncellemesinde `{id}`
data[].siparis_no	string	evet	L35-YYYYMMDD-XXXXXX; exe `websiparisid` (tekilleştirme anahtarı)
data[].musteri_id	integer	evet
data[].musteri_adi	string	evet
data[].musteri_telefon	string	evet	Ulusal biçim
data[].musteri_adres	string	evet	Tam metin: sokak/bina/kat/daire, mahalle, ilçe (+tarif); eski exe için
data[].musteri_adres_kisa	string	evet	Yalnız sokak/bina/kat/daire (+tarif); mahalle/ilçe ayrı alanlarda (26.10)
data[].musteri_enlem	number \| null	evet	Teslimat pini WGS84 (26.10); yoksa null → metin yedeği
data[].musteri_boylam	number \| null	evet
data[].musteri_il	string	evet	İzmir
data[].musteri_ilce	string	evet
data[].musteri_semt	string	evet	Boş dize olabilir
data[].musteri_mahalle	string	evet
data[].siparis_tipi	string	evet	Sabit "WP" (exe → "Y")
data[].teslimat_tipi	string	evet	PAKET \| GEL_AL \| MASA (xQR masa siparişi, K-44 Faz 2: YOLDA yok, hazır olunca servis; ödeme masada)
data[].masa_no	string \| null	evet	MASA siparişinde masa numarası/adı (QR'daki özgün yazım); diğerlerinde null
data[].odeme_turu	string	evet	NAKIT \| KAPIDA_KART \| ONLINE_KART \| YEMEK_KARTI — kasa tahsilat kararı bununla
data[].odendi	boolean	evet	Yalnız ONLINE_KART’ta true (iyzico’da tahsil edildi)
data[].odeme_yontemi	string	evet	Görünen ad / yemek kartı markası (Multinet, Sodexo, Edenred, Setcard, Metropol, Tokenflex, Paycell, iWallet); katalog 26.10
data[].para_ustu	number \| null	evet	Nakitte müşterinin vereceği tutar (TL); yoksa null (26.10)
data[].ara_toplam	number	evet	TL (Σ urunler[].toplam_fiyat, ödenen fiyatlarla)
data[].indirim_orani	number	hayır	Marka/site yüzde indirimi
data[].indirim_tutari	number	evet	Marka/site indirimi tutarı
data[].urun_indirimi	number	evet	Σ adet × urunler[].indirim (ürün indirimleri); indirim_tutari’na eklenmez (26.10)
data[].teslimat_ucreti	number	evet
data[].toplam_tutar	number	evet	ara_toplam − indirim_tutari + teslimat_ucreti
data[].durum	string	evet	v1 görünümü: BEKLEMEDE \| ONAYLANDI \| YOLDA \| TESLIM_EDILDI \| IPTAL (HAZIRLANIYOR → ONAYLANDI, REDDEDILDI → IPTAL)
data[].durum_text	string	evet	Türkçe etiket
data[].siparis_zamani	string	evet	dd.MM.yyyy HH:mm — başka biçim exe’de istisna (DateTime.ParseExact)
data[].teslim_tahmini	string \| null	evet	HH:mm
data[].siparis_notu	string	hayır
data[].marka.id	integer	evet	Şube/marka kimliği (v1Id); exe `entegrasyonresid` ile eşler
data[].marka.marka_adi	string	evet
data[].marka.subdomain	string	hayır
data[].marka.ana_marka	boolean	hayır
data[].urunler[].product_id	integer	evet	Lezzet35 ürün v1Id
data[].urunler[].siparismatik_id	string	hayır	Kasa ürün kimliği (eşleme)
data[].urunler[].kategori_siparismatik_id	string	hayır
data[].urunler[].urun_adi	string	evet	Sipariş anındaki ad
data[].urunler[].adet	integer	evet
data[].urunler[].birim_fiyat	number	evet	ÖDENEN birim fiyat (seçimler dahil)
data[].urunler[].liste_fiyat	number \| null	evet	İndirimsiz birim fiyat; indirim yoksa null (26.10)
data[].urunler[].indirim	number	evet	Birim başına ürün indirimi; yoksa 0 (26.10)
data[].urunler[].toplam_fiyat	number	evet
data[].urunler[].varyantlar[].id	integer	evet
data[].urunler[].varyantlar[].ad	string	evet
data[].urunler[].varyantlar[].fiyat	number	evet
data[].urunler[].ekstralar[].id	integer	evet
data[].urunler[].ekstralar[].ad	string	evet
data[].urunler[].ekstralar[].fiyat	number	evet
data[].urunler[].ozel_not	string	evet	Kalem notu; boş dize olabilir
data[].urunler[].menu	object \| null	evet	Menü seçimi: `{id, ad, fiyat, secilenler[]}`
data[].urunler[].menu.secilenler[].urun	string	evet
data[].urunler[].menu.secilenler[].fiyat	number	evet
meta.current_page	integer	hayır	Parametresiz çağrıda her zaman 1
meta.last_page	integer	hayır	Parametresiz çağrıda 1 (günün tüm aktif siparişleri tek sayfa)
meta.per_page	integer	hayır
meta.total	integer	hayır

curl

curl -X GET "$LEZZET35_URL/api/v1/firma/siparisler" \
  -H "Authorization: Bearer $FIRMA_API_ANAHTARI"

Kaynak: §4.3 · SiparisController.php:597-768 · Entegrasyon.cs:8281-8417

get/api/v1/firma/siparisler/{id}Hazır

Tek sipariş (24.10, Pro: fiş yeniden basımı)

Liste satırıyla aynı şekil (data:{…}); teslim edilen / iptal edilen sipariş de okunur. Başka firmanın siparişi ya da yok → 404; sayı olmayan id → 422.

Kimlik:: Bearer (firma anahtarı)

Parametreler

Ad	Konum	Zorunlu	Tip	Açıklama
id	path	evet	integer	Sipariş v1Id (`data[].id`) Örnek: 1042

Yanıtlar

200v1 zarfı: success JSON boolean, message; veri anahtarları alan tablosunda

Alan	Tip	Zorunlu	Açıklama
success	boolean	evet
message	string	hayır

401Kimlik başlığı eksik/yanlış: {success:false, message}

404Sipariş bulunamadı

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu	Açıklama
data.id	integer	evet	Sipariş v1Id; exe `messageid` — durum güncellemesinde `{id}`
data.siparis_no	string	evet	L35-YYYYMMDD-XXXXXX; exe `websiparisid` (tekilleştirme anahtarı)
data.musteri_id	integer	evet
data.musteri_adi	string	evet
data.musteri_telefon	string	evet	Ulusal biçim
data.musteri_adres	string	evet	Tam metin: sokak/bina/kat/daire, mahalle, ilçe (+tarif); eski exe için
data.musteri_adres_kisa	string	evet	Yalnız sokak/bina/kat/daire (+tarif); mahalle/ilçe ayrı alanlarda (26.10)
data.musteri_enlem	number \| null	evet	Teslimat pini WGS84 (26.10); yoksa null → metin yedeği
data.musteri_boylam	number \| null	evet
data.musteri_il	string	evet	İzmir
data.musteri_ilce	string	evet
data.musteri_semt	string	evet	Boş dize olabilir
data.musteri_mahalle	string	evet
data.siparis_tipi	string	evet	Sabit "WP" (exe → "Y")
data.teslimat_tipi	string	evet	PAKET \| GEL_AL \| MASA (xQR masa siparişi, K-44 Faz 2: YOLDA yok, hazır olunca servis; ödeme masada)
data.masa_no	string \| null	evet	MASA siparişinde masa numarası/adı (QR'daki özgün yazım); diğerlerinde null
data.odeme_turu	string	evet	NAKIT \| KAPIDA_KART \| ONLINE_KART \| YEMEK_KARTI — kasa tahsilat kararı bununla
data.odendi	boolean	evet	Yalnız ONLINE_KART’ta true (iyzico’da tahsil edildi)
data.odeme_yontemi	string	evet	Görünen ad / yemek kartı markası (Multinet, Sodexo, Edenred, Setcard, Metropol, Tokenflex, Paycell, iWallet); katalog 26.10
data.para_ustu	number \| null	evet	Nakitte müşterinin vereceği tutar (TL); yoksa null (26.10)
data.ara_toplam	number	evet	TL (Σ urunler[].toplam_fiyat, ödenen fiyatlarla)
data.indirim_orani	number	hayır	Marka/site yüzde indirimi
data.indirim_tutari	number	evet	Marka/site indirimi tutarı
data.urun_indirimi	number	evet	Σ adet × urunler[].indirim (ürün indirimleri); indirim_tutari’na eklenmez (26.10)
data.teslimat_ucreti	number	evet
data.toplam_tutar	number	evet	ara_toplam − indirim_tutari + teslimat_ucreti
data.durum	string	evet	v1 görünümü: BEKLEMEDE \| ONAYLANDI \| YOLDA \| TESLIM_EDILDI \| IPTAL (HAZIRLANIYOR → ONAYLANDI, REDDEDILDI → IPTAL)
data.durum_text	string	evet	Türkçe etiket
data.siparis_zamani	string	evet	dd.MM.yyyy HH:mm — başka biçim exe’de istisna (DateTime.ParseExact)
data.teslim_tahmini	string \| null	evet	HH:mm
data.siparis_notu	string	hayır
data.marka.id	integer	evet	Şube/marka kimliği (v1Id); exe `entegrasyonresid` ile eşler
data.marka.marka_adi	string	evet
data.marka.subdomain	string	hayır
data.marka.ana_marka	boolean	hayır
data.urunler[].product_id	integer	evet	Lezzet35 ürün v1Id
data.urunler[].siparismatik_id	string	hayır	Kasa ürün kimliği (eşleme)
data.urunler[].kategori_siparismatik_id	string	hayır
data.urunler[].urun_adi	string	evet	Sipariş anındaki ad
data.urunler[].adet	integer	evet
data.urunler[].birim_fiyat	number	evet	ÖDENEN birim fiyat (seçimler dahil)
data.urunler[].liste_fiyat	number \| null	evet	İndirimsiz birim fiyat; indirim yoksa null (26.10)
data.urunler[].indirim	number	evet	Birim başına ürün indirimi; yoksa 0 (26.10)
data.urunler[].toplam_fiyat	number	evet
data.urunler[].varyantlar[].id	integer	evet
data.urunler[].varyantlar[].ad	string	evet
data.urunler[].varyantlar[].fiyat	number	evet
data.urunler[].ekstralar[].id	integer	evet
data.urunler[].ekstralar[].ad	string	evet
data.urunler[].ekstralar[].fiyat	number	evet
data.urunler[].ozel_not	string	evet	Kalem notu; boş dize olabilir
data.urunler[].menu	object \| null	evet	Menü seçimi: `{id, ad, fiyat, secilenler[]}`
data.urunler[].menu.secilenler[].urun	string	evet
data.urunler[].menu.secilenler[].fiyat	number	evet

curl

curl -X GET "$LEZZET35_URL/api/v1/firma/siparisler/1042" \
  -H "Authorization: Bearer $FIRMA_API_ANAHTARI"

Kaynak: modules/M11-entegrasyon/v1-siparis.ts v1SiparisGetir

put/api/v1/firma/siparisler/{id}/durumHazır

Sipariş durumu (exe → Lezzet35)

tbl_siparis.guncelle='Y' olan WEB siparişleri için. Exe eşlemesi: BEKLIYOR→ONAYLANDI, ONAY→YOLDA, TESLIM→TESLIM_EDILDI, IPTAL/RED→IPTAL. Lezzet35 M06 durum makinesini uygular; geçersiz geçişte de `success:true` döner (aksi halde exe sonsuza kadar tekrar eder) ve olayı IntegrationLog’a "reddedildi" yazar. Exe success="True" görünce bayrağı temizler.

Kimlik:: Bearer (firma anahtarı)

Parametreler

Ad	Konum	Zorunlu	Tip	Açıklama
id	path	evet	integer	Sipariş v1Id (`data[].id`, exe `messageid`) Örnek: 1042

İstek gövdesi (application/json)

Alan	Tip	Zorunlu	Açıklama
durum	enum(BEKLEMEDE \| ONAYLANDI \| HAZIRLANIYOR \| YOLDA \| TESLIM_EDILDI \| IPTAL \| REDDEDILDI)	evet
iptal_nedeni	string	hayır	v2.0: iptal/ret nedeni kodu (GET /iptal-nedenleri); bilinmeyen kod 422
durum_aciklama	string	hayır
tahmini_sure_dk	integer	hayır

Yanıtlar

200v1 zarfı: success JSON boolean, message; veri anahtarları alan tablosunda

Alan	Tip	Zorunlu	Açıklama
success	boolean	evet
message	string	hayır

401Kimlik başlığı eksik/yanlış: {success:false, message}

404Başka firmanın siparişi ya da yok

422Geçersiz durum değeri

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu	Açıklama
durum	string	evet	İstek; 7 değer kabul, exe 4’ünü gönderir
iptal_nedeni	string	hayır	İstek (v2.0): iptal/ret nedeni kodu — `GET /iptal-nedenleri` listesinden; DIGER'de durum_aciklama zorunlu
durum_aciklama	string	hayır	İstek; iptal/ret sebebi (≤ 500)
tahmini_sure_dk	integer	hayır	İstek (24.10): teslim_tahmini = şimdi + dk; uç durumda yok sayılır
odendi	boolean	hayır	İstek (27.10): hesap kapanışı; uç durumda da yazılır, `GET` `odendi` bunu döner
odeme_turu	string	hayır	İstek (27.10): gerçek ödeme türü NAKIT\|KAPIDA_KART\|ONLINE_KART\|YEMEK_KARTI (masa/kasa kapanışı)
success	boolean	evet	Geçersiz geçişte de true
data.siparis_no	string	hayır
data.durum	string	hayır
data.durum_text	string	hayır
data.teslim_tahmini	string \| null	hayır	HH:mm (24.10)
data.degisti	boolean	hayır	Durum gerçekten değişti mi (24.10)
data.reddedildi	boolean	hayır	Geçersiz geçiş: uygulanmadı, message açıklar (24.10)

curl

curl -X PUT "$LEZZET35_URL/api/v1/firma/siparisler/1042/durum" \
  -H "Authorization: Bearer $FIRMA_API_ANAHTARI" \
  -H "Content-Type: application/json" \
  -d '{"durum":"YOLDA"}'

Kaynak: §4.3 · SiparisController.php:773-828 · Entegrasyon.cs:8462-8476

post/api/v1/xqr/kayitHazır

xQR kaydı (Pro kasası → kod + alt alan)

Kimlik (Owner 26.10 gece: "kayıtta SiparişMatik ID kullanılsın"): X-Pool-Secret + istemci IP Pro paneli sunucusu (XQR_KAYIT_IZINLI_IP) + firmaid SiparişMatik yönetim listesinde var; telefon yalnız bilgi alanı (Firma/Şube telefonu). Firma Lezzet35'te yoksa Firma + ana marka + Merkez şube (pazaryeri dışı, açık) + sahip hesabı + tek seferlik api_key kurulur → 201. Firma zaten varsa yalnız xQR sitesi açılır → 200, api_key: null (mevcut Bearer geçerli). Aynı firmaid ile tekrar → aynı kod (idempotent). Hız sınırı firmaid başına 5/saat, IP başına 120/saat (kayıtlar Pro panelinden tek IP ile gelir).

Kimlik:: X-Pool-Secret

İstek gövdesi (application/json)

Alan	Tip	Zorunlu	Açıklama
firmaid	integer	evet
ad	string	evet
telefon	string	evet	İşletme telefonu (cep ya da sabit hat, 10–11 hane); yalnız bilgi — eşleşme aranmaz
cep	string	hayır	Sahip cebi (isteğe bağlı): restoran paneli OTP girişi; yoksa telefon cepse o kullanılır
adres	string	evet
il	string	evet	İl adı ya da plaka kodu
ilce	string	evet
konum	nesne	hayır
konum.enlem	number	hayır
konum.boylam	number	hayır
masa_siparis	boolean	hayır
masa_sayisi	integer	hayır
diller	dizi<enum(en \| de \| ar \| ru)>	hayır

Yanıtlar

200v1 zarfı: success JSON boolean, message; veri anahtarları alan tablosunda

Alan	Tip	Zorunlu	Açıklama
success	boolean	evet
message	string	hayır

201Yeni firma + xQR sitesi kuruldu; data.api_key tek sefer

Alan	Tip	Zorunlu	Açıklama
success	boolean	evet
message	string	hayır

401Kimlik başlığı eksik/yanlış: {success:false, message}

403İstemci IP izinli listede değil ya da firmaid SiparişMatik listesinde yok

409Firma Lezzet35'te aktif değil / şubesi yok

422Doğrulama hatası (il/ilçe eşleşmedi, masa_sayisi, diller)

429IP başına 5/saat aşıldı

503SiparişMatik doğrulaması yapılandırılmamış ya da liste alınamadı

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu	Açıklama
data.kod	string	evet	4 karakter; `https://{kod}.xqr.com.tr`
data.url	string	evet	Sitenin tam adresi (kapı etiketi QR'ı); masa QR'ı `{url}/masa/{no}`
data.api_key	string \| null	evet	Yalnız yeni firmada (201), tek sefer; Pro Bearer olarak saklar
data.firma_id	string	evet	Lezzet35 firma kimliği
data.lezzet35	boolean	evet	Firma zaten Lezzet35'te miydi
data.online_url	string \| null	evet	Müşteriye açık online sipariş adresi (markalı site / pazaryeri sayfası) ya da null

curl

curl -X POST "$LEZZET35_URL/api/v1/xqr/kayit" \
  -H "X-Pool-Secret: $POOL_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"firmaid":2456,"ad":"01 Lokman Usta","telefon":"05438676447","adres":"Saim Çıkrıkçı Cad. No 206","il":"İzmir","ilce":"Karabağlar","konum":{"enlem":38.38,"boylam":27.11},"masa_siparis":true,"masa_sayisi":20,"diller":["en"]}'

Kaynak: docs/api/xqr-sozlesme-taslagi.md §2

get/api/v1/xqrHazır

xQR ayarları

Kimlik:: Bearer (firma anahtarı)

Yanıtlar

200v1 zarfı: success JSON boolean, message; veri anahtarları alan tablosunda

Alan	Tip	Zorunlu	Açıklama
success	boolean	evet
message	string	hayır

401Kimlik başlığı eksik/yanlış: {success:false, message}

404Firma xQR'a kayıtlı değil

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu	Açıklama
data.kod	string	evet
data.url	string	evet
data.masa_siparis	boolean	evet	Masadan sipariş açık mı (Faz 2)
data.masa_sayisi	integer	evet	1–200
data.diller	string[]	evet	en\|de\|ar\|ru
data.brosur	object \| null	evet	`{surum, url, pdf_url}` (Faz 4) ya da null

curl

curl -X GET "$LEZZET35_URL/api/v1/xqr" \
  -H "Authorization: Bearer $FIRMA_API_ANAHTARI"

Kaynak: docs/api/xqr-sozlesme-taslagi.md §3

put/api/v1/xqrHazır

xQR ayarlarını güncelle (masadan sipariş anahtarı)

Kimlik:: Bearer (firma anahtarı)

İstek gövdesi (application/json)

Alan	Tip	Zorunlu
masa_siparis	boolean	hayır
masa_sayisi	integer	hayır
diller	dizi<enum(en \| de \| ar \| ru)>	hayır

Yanıtlar

200v1 zarfı: success JSON boolean, message; veri anahtarları alan tablosunda

Alan	Tip	Zorunlu	Açıklama
success	boolean	evet
message	string	hayır

401Kimlik başlığı eksik/yanlış: {success:false, message}

404Firma xQR'a kayıtlı değil

422Doğrulama hatası

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu	Açıklama
masa_siparis	boolean	hayır	İstek
masa_sayisi	integer	hayır	İstek; 1–200
diller	string[]	hayır	İstek
data	object	evet	GET ile aynı gövde

curl

curl -X PUT "$LEZZET35_URL/api/v1/xqr" \
  -H "Authorization: Bearer $FIRMA_API_ANAHTARI" \
  -H "Content-Type: application/json" \
  -d '{"masa_siparis":false}'

Kaynak: docs/api/xqr-sozlesme-taslagi.md §3

put/api/v1/xqr/brosurHazır

Broşür PDF'ini barındır (Pro üretir, Lezzet35 sunar)

multipart: dosya (PDF, ≤ 10 MB, %PDF- imzası), surum (artan tam sayı; eski/aynı sürüm 409), tasarim (1–4, bilgi). Sonuç https://{kod}.xqr.com.tr/b (3 düğme + gömülü PDF) ve /b.pdf?v={surum}. Eski sürüm dosyası silinir. 10/dk.

Kimlik:: Bearer (firma anahtarı)

Yanıtlar

200v1 zarfı: success JSON boolean, message; veri anahtarları alan tablosunda

Alan	Tip	Zorunlu	Açıklama
success	boolean	evet
message	string	hayır

201Broşür kaydedildi

Alan	Tip	Zorunlu	Açıklama
success	boolean	evet
message	string	hayır

401Kimlik başlığı eksik/yanlış: {success:false, message}

404Firma xQR'a kayıtlı değil

409surum mevcut sürümden büyük değil

422dosya/surum doğrulaması

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu	Açıklama
data.surum	integer	evet
data.boyut	integer	evet	bayt
data.url	string	evet	`https://{kod}.xqr.com.tr/b`
data.pdf_url	string	evet	`https://{kod}.xqr.com.tr/b.pdf`

curl

curl -X PUT "$LEZZET35_URL/api/v1/xqr/brosur" \
  -H "Authorization: Bearer $FIRMA_API_ANAHTARI"

Kaynak: docs/api/xqr-sozlesme-taslagi.md §7

delete/api/v1/xqr/brosurHazır

Broşürü kaldır

Kimlik:: Bearer (firma anahtarı)

Yanıtlar

200v1 zarfı: success JSON boolean, message; veri anahtarları alan tablosunda

Alan	Tip	Zorunlu	Açıklama
success	boolean	evet
message	string	hayır

401Kimlik başlığı eksik/yanlış: {success:false, message}

404Firma xQR'a kayıtlı değil

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu	Açıklama
data.silindi	boolean	evet	Zaten yoksa false

curl

curl -X DELETE "$LEZZET35_URL/api/v1/xqr/brosur" \
  -H "Authorization: Bearer $FIRMA_API_ANAHTARI"

Kaynak: docs/api/xqr-sozlesme-taslagi.md §7

get/api/v1/firma/masa-olaylariHazır

Masa olayları: garson çağır / hesap iste

Pro 10 sn sipariş döngüsüne eklenir (?durum=acik varsayılan). Müşteri masa sayfasındaki düğmeyle açar; aynı masada aynı türde açık olay tekrar açılmaz. sonSenkron damgalanır.

Kimlik:: Bearer (firma anahtarı)

Parametreler

Ad	Konum	Zorunlu	Tip	Açıklama
durum	query	hayır	string (acik \| kapandi \| tumu)	acik (varsayılan) \| kapandi \| tumu

Yanıtlar

200v1 zarfı: success JSON boolean, message; veri anahtarları alan tablosunda

Alan	Tip	Zorunlu	Açıklama
success	boolean	evet
message	string	hayır

401Kimlik başlığı eksik/yanlış: {success:false, message}

422Geçersiz durum

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu	Açıklama
data[].id	integer	evet	Olay kimliği; kapatma ucunda kullanılır
data[].masa_no	string	evet	Masa (QR'daki numara ya da kısa ad)
data[].tur	string	evet	GARSON \| HESAP
data[].not	string \| null	hayır	Müşteri notu (≤ 200)
data[].durum	string	evet	ACIK \| KAPANDI
data[].olusturma	string	evet	ISO 8601 (UTC)
data[].kapanis	string \| null	evet	ISO 8601 (UTC) ya da null
toplam	integer	evet

curl

curl -X GET "$LEZZET35_URL/api/v1/firma/masa-olaylari" \
  -H "Authorization: Bearer $FIRMA_API_ANAHTARI"

Kaynak: docs/api/xqr-sozlesme-taslagi.md §6

put/api/v1/firma/masa-olaylari/{id}Hazır

Masa olayını kapat (garson gitti / hesap götürüldü)

Kimlik:: Bearer (firma anahtarı)

Parametreler

Ad	Konum	Zorunlu	Tip	Açıklama
id	path	evet	integer	Masa olayı kimliği (`data[].id`) Örnek: 17

İstek gövdesi (application/json)

Alan	Tip	Zorunlu	Açıklama
durum	enum(KAPANDI)	evet

Yanıtlar

200v1 zarfı: success JSON boolean, message; veri anahtarları alan tablosunda

Alan	Tip	Zorunlu	Açıklama
success	boolean	evet
message	string	hayır

401Kimlik başlığı eksik/yanlış: {success:false, message}

404Başka firmanın olayı ya da yok

422Geçersiz gövde

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu	Açıklama
durum	string	evet	İstek; yalnız KAPANDI
data.id	integer	evet
data.durum	string	evet	KAPANDI
data.kapanis	string	evet	ISO 8601
data.degisti	boolean	evet	Zaten kapalıysa false (idempotent)

curl

curl -X PUT "$LEZZET35_URL/api/v1/firma/masa-olaylari/17" \
  -H "Authorization: Bearer $FIRMA_API_ANAHTARI" \
  -H "Content-Type: application/json" \
  -d '{"durum":"KAPANDI"}'

Kaynak: docs/api/xqr-sozlesme-taslagi.md §6

Partner API v2 (Faz 6)

Diğer restoran yazılımları ve mobil uygulama için Partner API — taslak; Faz 6’da kontrat testleriyle sabitlenir

get/api/v2/restoranlarTaslak · Faz 6

Partnerin bağlı şubeleri

Anahtarın kapsamındaki şubeler (çoklu kiracı: bir anahtar birden çok şube yönetebilir). Kimlikler v2’de metin (cuid); v1’deki sayısal v1Id yalnız SiparişMatik için.

Kimlik:: X-Api-Key (partner)
Hız sınırı:: Partner başına 600 / dk (kota sözleşmeyle)

Yanıtlar

200{success, data} zarfı; şekil alan tablosunda

Alan	Tip	Zorunlu	Açıklama
success	= true	evet
data	nesne	evet

401API anahtarı eksik/yanlış

429Partner kotası aşıldı

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu	Açıklama
data[].id	string	evet	Şube kimliği
data[].ad	string	evet
data[].marka	string	evet	Vitrin adı
data[].ilce	string	evet
data[].acik	boolean	evet
data[].calismaSaatleri[]	object[]	hayır	`{gun, acilis, kapanis}`

curl

curl -X GET "$LEZZET35_URL/api/v2/restoranlar" \
  -H "X-Api-Key: $PARTNER_API_ANAHTARI"

get/api/v2/restoranlar/{subeId}/menuTaslak · Faz 6

Şube menüsü

Kategoriler, ürünler, varyant/ekstra/menü grupları ve şube fiyatları. Fiyatlar kuruş (tam sayı).

Kimlik:: X-Api-Key (partner)
Hız sınırı:: Partner başına 600 / dk (kota sözleşmeyle)

Parametreler

Ad	Konum	Zorunlu	Tip	Açıklama
subeId	path	evet	string	Şube kimliği (cuid) Örnek: cmfl3k9x40000abcd1234efgh

Yanıtlar

200{success, data} zarfı; şekil alan tablosunda

Alan	Tip	Zorunlu	Açıklama
success	= true	evet
data	nesne	evet

401API anahtarı eksik/yanlış

404Şube anahtarın kapsamında değil

429Partner kotası aşıldı

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu	Açıklama
data.kategoriler[]	object[]	evet	`{id, ad, sira, durum}`
data.urunler[]	object[]	evet	`{id, kategoriId, ad, aciklama, fiyatKurus, indirimliFiyatKurus, durum, disKimlik}`
data.urunler[].varyantGruplari[]	object[]	hayır
data.urunler[].ekstraGruplari[]	object[]	hayır

curl

curl -X GET "$LEZZET35_URL/api/v2/restoranlar/cmfl3k9x40000abcd1234efgh/menu" \
  -H "X-Api-Key: $PARTNER_API_ANAHTARI"

put/api/v2/restoranlar/{subeId}/menuTaslak · Faz 6

Menü senkronu (partner → Lezzet35)

Tam ya da kısmi menü gönderimi; disKimlik eşleme anahtarı. Yeni kayıt moderasyon kuyruğuna düşer (F4). İdempotent; Idempotency-Key zorunlu. Yanıt summary {created, updated, skipped}.

Kimlik:: X-Api-Key (partner)
Hız sınırı:: Partner başına 600 / dk (kota sözleşmeyle)

Parametreler

Ad	Konum	Zorunlu	Tip	Açıklama
subeId	path	evet	string	Şube kimliği (cuid) Örnek: cmfl3k9x40000abcd1234efgh
Idempotency-Key	header	evet	string	Partnerin ürettiği tekil anahtar (UUID); aynı anahtarla tekrar → ilk yanıt, yan etki yok (24 sa) Örnek: 6f1c2a0e-3b8e-4c8f-9c1a-2d5f7a9b1c33

İstek gövdesi (application/json)

Alan	Tip	Zorunlu	Açıklama
kategoriler	dizi<nesne>	hayır
urunler	dizi<nesne>	evet

Yanıtlar

200{success, data} zarfı; şekil alan tablosunda

Alan	Tip	Zorunlu	Açıklama
success	= true	evet
data	nesne	evet

400Doğrulama hatası (alan bazlı)

401API anahtarı eksik/yanlış

409Aynı Idempotency-Key farklı gövdeyle

429Partner kotası aşıldı

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu	Açıklama
urunler[].disKimlik	string	evet	Partner ürün kimliği
urunler[].ad	string	evet
urunler[].fiyatKurus	integer	evet	Kuruş
urunler[].kategoriDisKimlik	string	hayır
urunler[].durum	AKTIF \| PASIF	hayır
data.summary	object	evet	`{created, updated, skipped}`

curl

curl -X PUT "$LEZZET35_URL/api/v2/restoranlar/cmfl3k9x40000abcd1234efgh/menu" \
  -H "X-Api-Key: $PARTNER_API_ANAHTARI" \
  -H "Content-Type: application/json" \
  -d '{"kategoriler":[{"disKimlik":"12","ad":"Kumrular","sira":1}],"urunler":[{"disKimlik":"1001","kategoriDisKimlik":"12","ad":"Klasik Kumru","fiyatKurus":12000,"durum":"AKTIF"}]}'

put/api/v2/restoranlar/{subeId}/durumTaslak · Faz 6

Şubeyi aç/kapat

Kimlik:: X-Api-Key (partner)
Hız sınırı:: Partner başına 600 / dk (kota sözleşmeyle)

Parametreler

Ad	Konum	Zorunlu	Tip	Açıklama
subeId	path	evet	string	Şube kimliği (cuid) Örnek: cmfl3k9x40000abcd1234efgh

İstek gövdesi (application/json)

Alan	Tip	Zorunlu	Açıklama
acik	boolean	evet
neden	string	hayır

Yanıtlar

200{success, data} zarfı; şekil alan tablosunda

Alan	Tip	Zorunlu	Açıklama
success	= true	evet
data	nesne	evet

401API anahtarı eksik/yanlış

429Partner kotası aşıldı

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu	Açıklama
acik	boolean	evet	İstek
neden	string	hayır	Vitrinde gösterilmez; panelde loglanır
data.acik	boolean	evet

curl

curl -X PUT "$LEZZET35_URL/api/v2/restoranlar/cmfl3k9x40000abcd1234efgh/durum" \
  -H "X-Api-Key: $PARTNER_API_ANAHTARI" \
  -H "Content-Type: application/json" \
  -d '{"acik":false,"neden":"Yoğunluk"}'

get/api/v2/siparislerTaslak · Faz 6

Siparişleri listele

Webhook yerine ya da yanında çekme (polling) yolu. since ile artımlı; imleç tabanlı sayfalama (meta.sonraki).

Kimlik:: X-Api-Key (partner)
Hız sınırı:: Partner başına 600 / dk (kota sözleşmeyle)

Parametreler

Ad	Konum	Zorunlu	Tip	Açıklama
durum	query	hayır	string (ALINDI \| ONAYLANDI \| HAZIRLANIYOR \| YOLDA \| TESLIM_EDILDI \| IPTAL \| REDDEDILDI)
since	query	hayır	string	ISO 8601; bu andan sonra güncellenenler
imlec	query	hayır	string	Önceki yanıtın `meta.sonraki` değeri

Yanıtlar

200{success, data} zarfı; şekil alan tablosunda

Alan	Tip	Zorunlu	Açıklama
success	= true	evet
data	nesne	evet

401API anahtarı eksik/yanlış

429Partner kotası aşıldı

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu	Açıklama
data[]	object[]	evet	Sipariş özeti: `{id, no, subeId, durum, toplamKurus, olusturuldu, guncellendi}`
meta.sonraki	string \| null	evet	Sonraki sayfa imleci

curl

curl -X GET "$LEZZET35_URL/api/v2/siparisler" \
  -H "X-Api-Key: $PARTNER_API_ANAHTARI"

get/api/v2/siparisler/{id}Taslak · Faz 6

Sipariş detayı

Kalemler ve seçimler sipariş anındaki anlık görüntü; müşteri PII’si yalnız teslimat için gereken kadar (ad, telefon, adres).

Kimlik:: X-Api-Key (partner)
Hız sınırı:: Partner başına 600 / dk (kota sözleşmeyle)

Parametreler

Ad	Konum	Zorunlu	Tip	Açıklama
id	path	evet	string	Sipariş kimliği (cuid) ya da numarası (L35-…) Örnek: L35-20260916-4F2A9C

Yanıtlar

200{success, data} zarfı; şekil alan tablosunda

Alan	Tip	Zorunlu	Açıklama
success	= true	evet
data	nesne	evet

401API anahtarı eksik/yanlış

404Sipariş anahtarın kapsamında değil

429Partner kotası aşıldı

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu	Açıklama
data.id	string	evet
data.no	string	evet	L35-YYYYMMDD-XXXXXX
data.durum	string	evet	M06 iç durum
data.kalemler[]	object[]	evet	`{urunAdi, adet, birimFiyatKurus, toplamKurus, secimler[], not}`
data.teslimat	object	evet	`{tip, adres, mahalle, not}`
data.odeme	object	evet	`{tur, toplamKurus, tahsilatGerekli}`

curl

curl -X GET "$LEZZET35_URL/api/v2/siparisler/L35-20260916-4F2A9C" \
  -H "X-Api-Key: $PARTNER_API_ANAHTARI"

put/api/v2/siparisler/{id}/durumTaslak · Faz 6

Sipariş durumunu güncelle

M06 durum makinesi kaynak: restoran kurallarıyla; geçersiz geçiş 400 döner (v1’den farklı: partnerin tekrar döngüsü yok). İdempotent.

Kimlik:: X-Api-Key (partner)
Hız sınırı:: Partner başına 600 / dk (kota sözleşmeyle)

Parametreler

Ad	Konum	Zorunlu	Tip	Açıklama
id	path	evet	string	Sipariş kimliği (cuid) ya da numarası (L35-…) Örnek: L35-20260916-4F2A9C
Idempotency-Key	header	evet	string	Partnerin ürettiği tekil anahtar (UUID); aynı anahtarla tekrar → ilk yanıt, yan etki yok (24 sa) Örnek: 6f1c2a0e-3b8e-4c8f-9c1a-2d5f7a9b1c33

İstek gövdesi (application/json)

Alan	Tip	Zorunlu
durum	enum(ONAYLANDI \| HAZIRLANIYOR \| YOLDA \| TESLIM_EDILDI \| IPTAL \| REDDEDILDI)	evet
aciklama	string	hayır
teslimTahminiDk	integer	hayır

Yanıtlar

200{success, data} zarfı; şekil alan tablosunda

Alan	Tip	Zorunlu	Açıklama
success	= true	evet
data	nesne	evet

400Geçersiz geçiş ya da doğrulama

401API anahtarı eksik/yanlış

404Sipariş yok

429Partner kotası aşıldı

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu	Açıklama
durum	string	evet	İstek
aciklama	string	hayır	Müşteriye gösterilir (ret/iptal nedeni)
teslimTahminiDk	integer	hayır	Onayda tahmini süre
data.onceki	string	evet
data.yeni	string	evet

curl

curl -X PUT "$LEZZET35_URL/api/v2/siparisler/L35-20260916-4F2A9C/durum" \
  -H "X-Api-Key: $PARTNER_API_ANAHTARI" \
  -H "Content-Type: application/json" \
  -d '{"durum":"ONAYLANDI","teslimTahminiDk":35}'

post/api/v2/webhooksTaslak · Faz 6

Webhook aboneliği

Olaylar: siparis.olusturuldu, siparis.durum, menu.degisti, sube.durum. Teslim: POST url, gövde {olay, kimlik, zaman, veri}; başlıklar X-Lezzet35-Olay, X-Lezzet35-Teslim-Id, X-Lezzet35-Imza: sha256=HMAC_SHA256(gizliAnahtar, hamGovde). 2xx dışı → üstel geri çekilme ile 5 deneme (1, 2, 5, 15, 60 dk), sonra dead-letter ve panelde uyarı. Sipariş oluştuğunda teslim hedefi ≤ 2 sn.

Kimlik:: X-Api-Key (partner)
Hız sınırı:: Partner başına 600 / dk (kota sözleşmeyle)

İstek gövdesi (application/json)

Alan	Tip	Zorunlu	Açıklama
url	string (uri)	evet
olaylar	dizi<enum(siparis.olusturuldu \| siparis.durum \| menu.degisti \| sube.durum)>	evet
gizliAnahtar	string	hayır	Verilmezse sunucu üretir ve yalnız bu yanıtta gösterir

Yanıtlar

200{success, data} zarfı; şekil alan tablosunda

Alan	Tip	Zorunlu	Açıklama
success	= true	evet
data	nesne	evet

400URL https değil ya da olay bilinmiyor

401API anahtarı eksik/yanlış

429Partner kotası aşıldı

Sözleşme alanları (taslak)

Alan	Tip	Zorunlu	Açıklama
url	uri (https)	evet	İstek
olaylar[]	string[]	evet	İstek
gizliAnahtar	string	hayır	İstek; ≥ 32 karakter
data.id	string	evet	Abonelik kimliği
data.gizliAnahtar	string	evet	Yalnız bu yanıtta düz metin

curl

curl -X POST "$LEZZET35_URL/api/v2/webhooks" \
  -H "X-Api-Key: $PARTNER_API_ANAHTARI" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://pos.ornek.com/lezzet35/webhook","olaylar":["siparis.olusturuldu","siparis.durum"]}'

Kimlik doğrulama

Herkese açık JSON uçları (sağlık, OTP, mahalle arama) kimlik istemez. Diğer bölgeler dört şemadan biriyle korunur; hepsinde sır sunucuda özet (sha256) olarak saklanır.

bearerFirma · HTTP bearer

Authorization: Bearer <api_token> — firma anahtarı; sunucuda sha256 özeti saklanır, düz metin yalnız üretim anında admin’e bir kez gösterilir. SiparişMatik exe GET /pool ile alır.

bash

curl "$LEZZET35_URL/api/v1/firma/siparisler" \
  -H "Authorization: Bearer $FIRMA_API_ANAHTARI"

poolSecret · Başlık X-Pool-Secret

Tüm SiparişMatik kurulumlarında ortak, exe’ye gömülü anahtar (yalnız /api/v1/pool ve /pool/sms/log). Değiştirilemez; HAZIR penceresiyle daraltılır (KARAR-9).

bash

curl "$LEZZET35_URL/api/v1/pool" \
  -H "X-Pool-Secret: $POOL_SECRET_KEY"

partnerAnahtar · Başlık X-Api-Key

Partner API v2 anahtarı; sha256 özet, çoklu kiracı, partner başına kota (Faz 6).

bash

curl "$LEZZET35_URL/api/v2/restoranlar" \
  -H "X-Api-Key: $PARTNER_API_ANAHTARI"

cerezOturum · Çerez l35_oturum

Tarayıcı oturumu: HttpOnly, SameSite=Lax, 30 gün; /giris Server Action açar. Dahili sayfa/eylem yetkisi bu çerezle; herkese açık JSON uçları çerez istemez.

bash

# Tarayıcı çerezi; /giris akışı açar. Çerezi elle taşıma önerilmez.

Hız sınırı

Sabit pencereli sayaç, Redis üzerinde. Aşımda 429, retry-after başlığı ve yenidenSn alanı döner. Üretimde Redis erişilemezse uç 503 verir (fail-closed); geliştirmede uyarıyla geçer.

Uç	Sınır	Not
POST /api/auth/otp/istek	Telefon: 3 / 10 dk · IP: 21 / 10 dk	Ardışık istek 60 sn bekleme (`OTP_BEKLEME_SN`); e2e sunucusu gevşetir
POST /api/auth/otp/dogrula	Telefon: 10 / 10 dk	Kod başına 5 deneme (`OTP_MAX_DENEME`)
GET /api/bolge/mahalle-ara	IP: 60 / dk	Yanıt 60 sn önbellek
Restoran başvurusu (form)	IP: 5 / gün	Yalnız kayda giden gönderimler sayılır
/api/v1/pool*	IP: 30 / dk	X-Pool-Secret ortak anahtar
/api/v1/* firma uçları	Token: 120 / dk	Exe 10 sn’de ≤ 4 çağrı yapar
/api/v2/* (Faz 6)	Partner: 600 / dk	Kota sözleşmeyle; aşımda 429

Hata kodları

Hata zarfı: { success: false, message, errors? }. Mesajlar Türkçe ve kullanıcıya gösterilebilir; errors alan adı → mesaj listesi (yalnız 400). v1 katmanı WPSipariş zarfını korur.

Kod	Ad	Açıklama
400	Doğrulama hatası	Gövde/parametre şemaya uymuyor; `errors` alan bazlı mesajlar (Türkçe). Geçersiz JSON da 400.
401	Kimlik gerekli	Oturum çerezi, Bearer ya da X-Pool-Secret eksik/yanlış.
403	Yetki yok	Kimlik doğru ama kapsam dışı (başka firmanın şubesi, rol uymuyor).
404	Bulunamadı	Kayıt yok ya da kiracı sınırı dışında — ikisi aynı yanıt (varlık sızdırmaz).
409	Çakışma	Aynı Idempotency-Key farklı gövdeyle (v2).
422	İşlenemeyen içerik	Yalnız v1: WPSipariş doğrulama yanıtı biçimi (`Doğrulama hatası: …`).
429	Hız sınırı	`retry-after` başlığı ve `yenidenSn` alanı; sınırlar uç bazlı (bkz. Hız sınırı).
500	Sunucu hatası	Beklenmeyen hata; ayrıntı yalnız sunucu logunda (PII maskeli).
503	Hizmet dışı	Sağlık ucunda bağımlılık hatası; üretimde hız sınırı deposu (Redis) erişilemezse fail-closed.

Sürümleme

Belge sürümü 1.0.0 — anlamsal sürüm; kırıcı değişiklik büyük sürümü artırır ve yeni yol öneki açar.
/api/v1 SiparişMatik sözleşmesi dondurulmuştur: yol, başlık ve alan adları WPSipariş ile birebir; alan eklemek serbest, silmek/tip değiştirmek yasak (exe değişemez).
/api/v2 Partner API Faz 6’da yayınlanır; kırıcı değişiklik /api/v3 ile gelir, v2 en az 12 ay desteklenir.
Öneksiz uçlar (sağlık, OTP, bölge) dahili istemciler içindir; değişiklikler bu günlükte duyurulur.

Değişiklik günlüğü

1.0.0 2026-10-27
- Sözleşme v2.0: iki sistem — WhatsApp/markalı site (akis: whatsapp, kanal MARKA_SITESI+XQR) ve Pazaryeri (akis: pazaryeri, kanal WEB); anahtar akış kapsamlı, sipariş uçları yalnız kendi akışını görür; sipariş gövdesine akis alanı
- Webhook (Lezzet35 → SiparişMatik köprüsü, akış başına): siparis.olusturuldu / siparis.durum / siparis.iptal / test; JWT HS512 + X-Lezzet35-Signature; 10 deneme ≈ 24 sa (rehber: /docs/api/siparismatik)
- Jeton otomasyonu: anahtar ve webhook sırrı SiparişMatik sunucusuna entegrasyon.anahtar olayıyla itilir (X-Pool-Secret + imza)
- GET /iptal-nedenleri ve PUT …/durum iptal_nedeni (admin yönetir)
- musteri_il teslimat mahallesinin ilinden (sabit İzmir kaldırıldı)
0.9.0 2026-10-27
- xQR Faz 4: PUT|DELETE /xqr/brosur (PDF barındırma; /b sayfası ve /b.pdf)
- POST /xqr/kayit: X-Xqr-Panel-Key canlıda zorunlu (27.10)
0.8.0 2026-10-27
- xQR Faz 2: GET /firma/siparisler teslimat_tipi: MASA + masa_no (masa siparişi; YOLDA yok, hazır olunca servis, ödeme masada)
- POST /pool/products/sync ve GET /menu: salon_fiyat, alerjenler[], etiketler[] (bilinmeyen kod 422)
- POST /xqr/kayit: kimlik SiparişMatik ID + Pro paneli (telefon bilgi alanı), isteğe bağlı X-Xqr-Panel-Key
0.7.0 2026-10-26
- xQR (QR menü, K-44) Faz 1: POST /xqr/kayit (X-Pool-Secret; firmaid + telefon doğrulaması, 201 tek seferlik api_key), GET|PUT /xqr (masa_siparis, masa_sayisi, diller)
- GET /firma/masa-olaylari (garson çağır / hesap iste; Pro 10 sn çekimi) ve PUT /firma/masa-olaylari/{id} {durum:KAPANDI}
- Sözleşme: docs/api/xqr-sozlesme-taslagi.md
0.6.0 2026-10-26
- GET /firma/siparisler: urunler[].liste_fiyat, urunler[].indirim, urun_indirimi, para_ustu, musteri_enlem/musteri_boylam, musteri_adres_kisa, teslimat_tipi, odeme_turu, odendi, teslimat_ucreti belgeye eklendi
- GET /firma/siparisler/{id} tek sipariş; süzgeçler (durum, tarih_baslangic, tarih_bitis)
- PUT …/durum: tahmini_sure_dk; yanıtta teslim_tahmini, degisti, reddedildi
- Ödeme kataloğu: odeme_turu+odendi öncelikli, odeme_yontemi görünen ad / yemek kartı markası
0.5.0 2026-10-23
- SiparişMatik Pro çift yönlü menü senkronu: products/sync ek alanları (kdv, ekstralar, foto_url, silindi, guncellendi_at) ve conflicts[]
- GET /menu?since= artımlı çekme; guncellendi_at, silindi, ekstralar, kdv, summary.sunucu_zamani
- POST /pool/products/{sp_urun_id}/foto görsel yükleme
0.4.0 2026-10-23
- SiparişMatik v1 uçları canlı (Faz 6): havuz/connect/disconnect, categories/products sync, sms/log, status, branches, menu, firma/siparisler + durum
- Yeni ürün ONAY_BEKLIYOR; GET /firma/siparisler tek sayfa; ek alanlar teslimat_tipi, odeme_turu, odendi
- entegrasyon_gunlugu ve admin “bağlantı koptu” uyarısı
0.3.0 2026-09-16
- Belge ve /docs/api yayında (Faz 3)
- GET /api/openapi.json
- SiparişMatik v1 uçları sözleşmeden planlandı olarak eklendi
- Partner API v2 taslağı
0.2.0 2026-09-15
- GET /api/bolge/mahalle-ara — İzmir mahalle araması (Faz 2)
- Servis alanı çekirdeği (M04)
0.1.0 2026-09-14
- GET /api/health
- POST /api/auth/otp/istek, POST /api/auth/otp/dogrula (Faz 1)
- Yanıt zarfı {success, data | message, errors}