POS Entegrasyonu

Base URL

Kimlik Doğrulama

Tüm isteklerde x-secret-key header'ı gereklidir. Bu anahtar başvurunuz onaylandıktan sonra size iletilecektir.

Sipariş Durumu Güncelleme

POS sisteminizden sipariş durumunu güncellemek için bu endpoint'i kullanın.

Request Body

Geçerli Status Değerleri

Başarılı Yanıt

{
  "success": true,
  "message": "Webhook işlendi"
}

Yeni Sipariş Alımı

Yeni bir sipariş oluşturulduğunda HızırYemek, sizin API'nize aşağıdaki formatta bir POST isteği gönderir.

Payload Yapısı

{
  "orderId": "507f1f77bcf86cd799439011",
  "orderNumber": "HY-1234",
  "items": [
    {
      "name": "Adana Kebap",
      "quantity": 2,
      "unitPrice": 250,
      "totalPrice": 500,
      "options": [
        "Acılı",
        "Bol soğanlı"
      ]
    }
  ],
  "totals": {
    "subtotal": 500,
    "deliveryFee": 20,
    "total": 520
  },
  "address": {
    "full": "Atatürk Cad. No:1 D:5, Merkez/Şehir",
    "note": "3. kat, zili çalın"
  },
  "note": "Lütfen çatal bıçak koymayın"
}

Kod Örnekleri

cURL — Sipariş durumu güncelleme

curl -X POST https://www.hiziryemek.com/api/v1/pos-webhook/webhook \
  -H "Content-Type: application/json" \
  -H "x-secret-key: YOUR_SECRET_KEY" \
  -d '{
    "orderId": "507f1f77bcf86cd799439011",
    "status": "preparing"
  }'

JavaScript (fetch)

const response = await fetch('https://www.hiziryemek.com/api/v1/pos-webhook/webhook', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-secret-key': 'YOUR_SECRET_KEY',
  },
  body: JSON.stringify({
    orderId: '507f1f77bcf86cd799439011',
    status: 'preparing',
  }),
});

const data = await response.json();
console.log(data);
// { success: true, message: 'Webhook işlendi' }

Hata Kodları