​
Entegrasyon modeli

Pazaryeri entegrasyonları genellikle server-to-server çalışır. Bu nedenle origin header’ı olmayabilir; güvenlik token, scope, rate limit ve webhook imzası üzerinden sağlanır. Önerilen client adı: 
Trendyol Entegrasyonu
Hepsiburada Entegrasyonu
ERP Köprüsü

​
Gerekli scope’lar

Pazaryeri ürün senkronizasyonu: 
catalog:read
Sipariş okuma: 
order:read
Webhook yönetimi: 
webhook:manage

​
Ürün aktarımı

GET /marketplace/products endpointi pazaryeri senkronizasyonu için normalize ürün çıktısı verir. Bu response SKU, stok, fiyat, kategori ve görsel URL’lerini içerir.

​
Sipariş alma

Pazaryerinden gelen siparişleri Hemen Mağaza’ya yazmak için POST /orders veya özel marketplace order köprüsü kullanılabilir. Sipariş yazarken her kalem için SKU veya ürün ID eşleştirmesi yapılmalıdır.

​
Webhook ile güncelleme

Ürün güncellendiğinde: 
product.updated
stock.changed
Sipariş güncellendiğinde: 
order.created
order.paid
order.cancelled
eventleri entegrasyon sunucunuza gönderilir.

​
Idempotency

Pazaryeri siparişleri tekrar gönderilebilir. Aynı siparişin iki kez yazılmaması için idempotency anahtarı kullanın. 
Idempotency-Key: trendyol-order-123456

​
Operasyon önerisi

  • Her pazaryeri için ayrı client açın.
  • Her client’a sadece ilgili scope’ları verin.
  • Rate limitleri pazaryeri yoğunluğuna göre planlayın.
  • Webhook imzasını doğrulamadan sipariş veya stok güncellemesi işlemeyin.