İçe Aktarma Durumunu Al#

Durum uç noktası, mağazanın geçerli veya en yeni içe aktarma işini döndürür.

http

GET https://sdkapi.ideal.house/product-import/products/status?shopId=<SHOP_ID>

Sorgu Parametreleri#

Alan	Tür	Gerekli	Kısıtlamalar	Açıklama
`shopId`	string	Evet	En fazla 64 karakter	Toplu işlem gönderilirken kullanılan Shop ID.

cURL Örneği#

bash

curl --request GET \
  'https://sdkapi.ideal.house/product-import/products/status?shopId=shop_123' \
  --header 'X-Client-Id: <YOUR_CLIENT_ID>' \
  --header 'X-Client-Secret: <YOUR_CLIENT_SECRET>'

Yanıt Alanları#

Alan	Tür	Açıklama
`jobId`	string	İçe aktarma işinin tanımlayıcısı.
`shopId`	string	İşle ilgili mağaza.
`status`	string	Şu değerlerden biri: `pending`, `running`, `completed` veya `failed`.
`totalCount`	number	Gönderilen toplam ürün sayısı.
`processedCount`	number	Şu ana kadar işlenen ürün sayısı.
`successCount`	number	Başarıyla oluşturulan veya güncellenen ürün sayısı.
`failedCount`	number	Öğe düzeyinde işleme sırasında başarısız olan ürünlerin sayısı.
`failures`	array	Öğe düzeyindeki hatalar. Öğe düzeyinde hata oluşmadığında boştur.
`createdAt`	string	ISO 8601 biçiminde işin oluşturulma zamanı.
`startedAt`	string or null	ISO 8601 formatında işleme başlangıç zamanı.
`updatedAt`	string	ISO 8601 formatında son iş güncelleme zamanı.
`completedAt`	string or null	ISO 8601 biçiminde işin sona erme zamanı.
`error`	string or null	İş düzeyinde hata. Bu alan genellikle yalnızca `status` değeri `failed` olduğunda doldurulur.

processedCount eşittir successCount + failedCount.

successCount, ürünün katalogda oluşturulduğunu veya güncellendiğini doğrular. Bu, görüntü işlemenin başarılı olduğu veya ürünün hemen gösterime hazır olduğu anlamına gelmez.

failures içindeki her nesne şunları içerir:

Alan	Tür	Açıklama
`index`	number	Ürünün ilk gönderilen `products` dizisindeki sıfırdan başlayan konumu.
`sku`	string	İşlenmesi başarısız olan ürünün SKU değeri.
`message`	string	Hata açıklaması. Uygulama mantığını mesajın tam metnine bağlı olacak şekilde oluşturmayın.

İş Durumları#

Durum	Anlamı	Önerilen eylem
`pending`	İstek kabul edildi ve başlamayı bekliyor.	Durumu düzenli aralıklarla sorgulamaya devam edin.
`running`	Ürünler işleniyor.	Durumu sorgulamaya devam edin ve ilerlemeyi göstermek için sayaç alanlarını kullanın.
`completed`	Toplu işlemin işlenmesi tamamlandı. Bazı ürünlerin işlenmesi başarısız olmuş olabilir.	`failedCount` ve `failures` alanlarını kontrol edin.
`failed`	İş düzeyindeki bir hata, grubun normal şekilde tamamlanmasını engelledi.	`error` alanını inceleyin, ardından aşağıda açıklandığı gibi yeniden deneyin.

Ürün Düzeyinde Hatayla Tamamlanan İş#

json

{
  "jobId": "1930000000000000000",
  "shopId": "shop_123",
  "status": "completed",
  "totalCount": 2,
  "processedCount": 2,
  "successCount": 1,
  "failedCount": 1,
  "failures": [
    {
      "index": 1,
      "sku": "SKU-10002",
      "message": "Unable to import the remote image"
    }
  ],
  "createdAt": "2026-07-21T06:30:00.000Z",
  "startedAt": "2026-07-21T06:30:00.010Z",
  "updatedAt": "2026-07-21T06:30:08.000Z",
  "completedAt": "2026-07-21T06:30:08.000Z",
  "error": null
}

completed durumu, toplu iş akışının sona erdiğini belirtir; tüm ürünlerin başarıyla işlendiği anlamına gelmez. Bir ürünün işlenmesindeki hata, aynı gruptaki diğer ürünlerin işlenmesini durdurmaz.