आयात स्थिति प्राप्त करें#

स्थिति एंडपॉइंट शॉप के लिए वर्तमान या सबसे हालिया आयात जॉब लौटता है।

http

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

क्वेरी पैरामीटर#

फ़ील्ड	प्रकार	आवश्यक	प्रतिबंध	विवरण
`shopId`	string	हाँ	अधिकतम 64 अक्षर	बैच सबमिट किए जाने पर उपयोग किया गया Shop ID।

cURL उदाहरण#

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>'

प्रतिक्रिया फ़ील्ड#

फ़ील्ड	प्रकार	विवरण
`jobId`	string	आयात जॉब की पहचान।
`shopId`	string	जॉब से जुड़ा शॉप।
`status`	string	`pending`, `running`, `completed`, या `failed` में से एक।
`totalCount`	number	सबमिट किए गए उत्पादों की कुल संख्या।
`processedCount`	number	अब तक प्रोसेस किए गए उत्पादों की संख्या।
`successCount`	number	सफलतापूर्वक बनाए गए या अपडेट किए गए उत्पादों की संख्या।
`failedCount`	number	आइटम-स्तर की प्रोसेसिंग के दौरान विफल हुए उत्पादों की संख्या।
`failures`	array	आइटम-स्तर की विफलताएँ। जब कोई आइटम-स्तर की विफलता नहीं हुई होती है, तो यह खाली होता है।
`createdAt`	string	ISO 8601 प्रारूप में जॉब निर्माण समय।
`startedAt`	string or null	ISO 8601 प्रारूप में प्रोसेसिंग शुरू होने का समय।
`updatedAt`	string	ISO 8601 प्रारूप में अंतिम जॉब अपडेट समय।
`completedAt`	string or null	ISO 8601 प्रारूप में टर्मिनल समय।
`error`	string or null	जॉब-स्तर की त्रुटि। सामान्य रूप से केवल तभी भरा जाता है जब `status` `failed` हो।

processedCount successCount + failedCount के बराबर है।

successCount पुष्टि करता है कि उत्पाद कैटलॉग में बनाया या अपडेट किया गया था। इसका अनिवार्य रूप से यह अर्थ नहीं है कि इमेज प्रोसेसिंग सफल रही या उत्पाद तुरंत प्रदर्शन के लिए उपलब्ध है।

failures में प्रत्येक ऑब्जेक्ट में शामिल है:

फ़ील्ड	प्रकार	विवरण
`index`	number	मूल `products` एरे में उत्पाद की शून्य-आधारित स्थिति।
`sku`	string	विफल उत्पाद का SKU।
`message`	string	विफलता का विवरण। सटीक संदेश टेक्स्ट पर निर्भर ऐप्लिकेशन लॉजिक न बनाएं।

जॉब स्थितियाँ#

स्थिति	अर्थ	अनुशंसित कार्रवाई
`pending`	अनुरोध स्वीकृत किया गया है और शुरू होने का प्रतीक्षा कर रहा है।	पोलिंग जारी रखें।
`running`	उत्पादों की प्रोसेसिंग हो रही है।	पोलिंग जारी रखें और प्रगति प्रदर्शित करने के लिए काउंट फ़ील्ड का उपयोग करें।
`completed`	बैच प्रोसेसिंग समाप्त हो गई। कुछ उत्पाद अभी भी विफल हो सकते हैं।	`failedCount` और `failures` की जांच करें।
`failed`	जॉब-स्तर की त्रुटि ने बैच को सामान्य रूप से पूरा होने से रोक दिया।	`error` की समीक्षा करें, फिर नीचे वर्णित अनुसार पुनः प्रयास करें।

आइटम-स्तर की विफलता के साथ पूर्ण जॉब#

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 स्थिति का अर्थ है कि बैच वर्कफ़्लो समाप्त हो गया; इसका अर्थ यह नहीं है कि हर उत्पाद सफल रहा। आइटम-स्तर की विफलताएँ उसी बैच में अन्य उत्पादों को रोकती नहीं हैं।