Ideal House Product Import API#

Ideal House kataloğunuzdaki ürünleri içe aktarmak, listelemek ve mantıksal olarak silmek için Product Import API kullanın. Toplu içe aktarma 1 ile 500 arasında ürün kabul eder ve asenkron işlenir. Listeleme ve silme işlemleri senkron olarak işlenir.

Temel URL#

text

https://sdkapi.ideal.house

Tüm istekler için HTTPS kullanın. JSON istek ve yanıt gövdeleri UTF-8 olarak kodlanmıştır.

Başlamadan Önce#

Ideal House, ilk kurulum sürecinde aşağıdaki değerleri sağlayacaktır:

Shop ID
Client ID
Client Secret

Client ID ve Client Secret, sunucu tarafı kimlik bilgileridir. Client Secret bilgisini tarayıcı kodunda, mobil uygulamalarda, herkese açık depolarda, günlüklerde veya diğer istemci ortamlarında asla açığa çıkarmayın.

Kimlik doğrulama#

Bu başlıkları her isteğe ekleyin:

http

X-Client-Id: <YOUR_CLIENT_ID>
X-Client-Secret: <YOUR_CLIENT_SECRET>

JSON gövdesine sahip istekler için şunları da ekleyin:

http

Content-Type: application/json

İstekteki shopId, kimlik bilgileriyle ilişkili mağazayla eşleşmelidir. Eşleşmezse 403 Forbidden döndürülür.

API Özeti#

Yöntem	Yol	Amaç
`POST`	`/product-import/products`	Eşzamansız bir ürün içe aktarma toplu işlemi gönderin.
`GET`	`/product-import/products/status`	Geçerli veya en yeni içe aktarma işini alın.
`GET`	`/product-import/products`	Mağazanın mevcut ürünlerini listeleyin.
`DELETE`	`/product-import/products`	Bir ürünü Ürün Kimliği veya SKU'ya göre mantıksal olarak silin.

Toplu İçe Aktarma Akışı#

Bir ürün grubunu şununla gönderin: POST /product-import/products.
202 Accepted yanıtında döndürülen jobId değerini kaydedin.
Her 2 ila 5 saniyede bir GET /product-import/products/status uç noktasını sorgulayın.
Durum completed veya failed olduğunda sorgulamayı durdurun.
İşin durumu completed ise ürün düzeyindeki hatalar için failedCount ve failures alanlarını inceleyin.

Bir mağaza için aynı anda yalnızca bir içe aktarma işi etkin olabilir.