Çarşı'ya genel bakış

Ürünü olan işletmeler için katalog, sipariş ve işletme entegrasyonu.

Çarşı, ürünü olan işletmelerin dikeyidir: market, manav, kasap, şarküteri, kuruyemişçi, kırtasiye, petshop, çiçekçi. API'de bu dikey store değeriyle anılır. Restoranla aynı uçları kullanır; farkı sorular yaratır: yemekte menü ve seçenek grupları vardır, Çarşı'da barkod, stok ve toplama vardır. Çarşı'ya özgü uçlar yalnız bu dikeyde bulunur; restoran anahtarıyla çağrılırsa 404 not_available_for_vertical döner.

Beş adımda entegrasyon

İşletmeyi okuyun: GET /merchant ile vertical değerinin store olduğunu doğrulayın. Anahtarınız tek bir işletmeye bağlıdır; her işletme kendi anahtarını kullanır.
Kategorileri çekin: ürün hangi kategoriye bağlanabilir ve o kategoride hangi alanlar isteniyor?
Kataloğu aktarın (asenkron, istek başına en çok 1.000 kalem).
Günlük iş: fiyat ve stok güncellemesi.
Siparişleri alın, toplamayı yazın ve durumlarını ilerletin.

Kimlik doğrulama

HTTP Basic (apiKey:apiSecret) ve X-Integrator başlığı; restoranla aynıdır. Ayrıntı için Yetkilendirme.

İlk istek

curl "https://api.supergelsin.com/api/partner/v1/merchant" \
  -H "Authorization: Basic $(printf '%s:%s' "$API_KEY" "$API_SECRET" | base64)" \
  -H "X-Integrator: Ornek POS" \
  -H "X-Operator: kasiyer_01"

Toplu yazmalar asenkrondur

Ürün yazan her toplu uç 202 Accepted ve bir batchId döner; sonucu ayrı bir uçtan okursunuz. Yanıtın kendisi sonuç değildir.

GET/batches/{id}

Toplu işin durumu ve kalem bazında sonucu.

Senkron bir uçtan asenkrona geçiş kırıcı bir değişikliktir: yanıt işleme mantığı kimlik ve sorgulama döngüsüne göre baştan yazılmalıdır. Sözleşme bu nedenle ilk sürümden itibaren asenkrondur.

Hız sınırı servis grubu bazındadır

Kota uç başına değil grup başına sayılır; katalog yazma ve okuma, sipariş, işletme ve durum grupları ayrıdır. Büyük bir katalog yüklemesi sipariş kabulünü engellemez. Ayrıntı için Servis Limitleri sayfasına bakın.