Örnek Senaryo: Baştan Sona Mağaza Kurulumu

Bu sayfa, API ile sıfırdan bir mağaza kurulumunun tipik adımlarını özetler.

Akış

1. Tema rengini ve fontunu ayarlayın — PATCH /themes/{id}
2. Bir kategori oluşturun — POST /categories
3. Ürün görseli yükleyin — POST /media (multipart)
4. Ürün ve varyantını oluşturun — POST /products (görsel zorunlu, aksi halde ürün "aktif" duruma alınamaz)
5. Stok girin — PATCH /inventory
6. Bir açılış kampanyası tanımlayın — POST /campaigns
7. Sipariş bildirimleri için webhook kaydedin — POST /webhooks

Genel kurallar

• Yazma isteklerinden önce ilgili kaynağı GET ile okuyup mevcut durumu kontrol edin.
• Para alanlarını her zaman kuruş cinsinden, tam sayı veya sayısal metin olarak gönderin — ondalıklı sayı ("125.50") kabul edilmez.
• 422 hataları bir iş kuralı ihlalini (örn. görselsiz ürünü aktif yapmaya çalışmak), 409 bir benzersizlik çakışmasını (aynı SKU/slug) belirtir.

Tam parametre listesi için bkz. Uç Nokta Referansı.