Sürüm Notları

Public Integration API'sinde sürüm yönetimi URL ön ekiyle yapılır (/v1/, /v2/, vb.). Aynı sürüm içinde geriye uyumsuz değişiklik yapılmaz.

v1 · 13 Mayıs 2026

İlk yayın. 31 endpoint, HMAC-SHA256 kimlik doğrulama, 14 scope.

Eklenen domain'ler

• Catalog (variants, categories)
• Offers (CRUD, stock summary, digital items, batches)
• Orders (list, get, fulfillments, cancellations)
• Finance (overview, transactions, settlements, settlement items)
• Invoices (CRUD + multipart file)
• Claims (list, get, resolutions)
• Product Questions (list, answers)

Kapsamdan çıkarılanlar (out-of-scope)

• Webhook push delivery — incremental polling deseni önerilir. Bkz. Polling Deseni
• Bulk price/stock update — tek tek PATCH /v1/offers/{id} kullanın
• Onboarding / settings / team management — bu işlemler satıcı portali üzerinden yapılır
• Reports & dashboard — raw veriyi alıp kendi sisteminizde agregasyon yapın

Güvenlik

• HMAC-SHA256 + timestamp tolerans (300s) + nonce
• Cross-seller koruma — başka satıcının kaynağına erişim 404 Not Found döner (403 değil)
• Per-API-key rate limit (100 req/dk, sliding window)
• Idempotency-Key ile mutation güvenliği (24h TTL)

Bilinen sınırlamalar

• Sandbox/test ortamı şu an ayrıştırılmamıştır. Production karşı dikkatli test edin
• Webhook desteği yok — yol haritasında

Geleceğe yönelik

Önümüzdeki sürümlerde planlanan:

• Webhook altyapısı (event push delivery)
• Bulk price+inventory update (Trendyol parite)
• Sandbox ortamı ayrımı
• Resmi SDK paketleri (npm, NuGet, PyPI)