Entegrasyon Rehberi

1. Mimari

Tenant (bağlı proje) zorunlu değildir. Tanımlı değilse siparişler kuyruğa alınır ve API key ile çekilir.

2. Webhook URL'leri

Platform paneline tanımlanacak POST adresleri:

3. Pull — API Key ile sipariş alma

3.1 Yetkilendirme

API key yetkili ekip tarafından oluşturulur. İsteklerde header:

X-API-Key: amk_xxxxxxxxxxxxxxxx

3.2 Bekleyen siparişler

GET https://apimerkezi.dizeyazilim.com/public/api/v1/orders.php?limit=50

3.3 Teslim onayı

POST https://apimerkezi.dizeyazilim.com/public/api/v1/orders.php
Content-Type: application/json

{"id": 12}

3.4 Sistem durumu (JSON, API key gerekli)

GET https://apimerkezi.dizeyazilim.com/public/api/v1/health.php
X-API-Key: amk_...

Görsel durum paneli herkese açıktır: /health/

4. Push — Callback ile anlık iletim

1. Bağlı proje kaydı: proje kodu, consumer tipi, callback URL, secret
2. İlgili platform ayarında hedef proje seçimi
3. Hub POST {"order":{...}} gönderir; isteğe bağlı X-Hub-Secret

Genel JSON consumer herhangi bir webhook ucu ile uyumludur. Dizediji Menu consumer aynı gövdeyi api/siparis-merkezi.php ile kabul eder.

5. Sipariş şeması

{
  "platform": "yemeksepeti | getir | trendyol | migros_yemek",
  "platform_order_id": "string",
  "customer": { "name": "", "phone": "" },
  "address": { "full_address": "" },
  "items": [{ "name": "", "quantity": 1, "unit_price": 0 }],
  "payment": { "type": "platform_online", "total": 0 },
  "note": ""
}

6. HTTP kodları