Получение статуса импорта#
Конечная точка статуса возвращает текущее или последнее задание импорта для магазина.
GET https://sdkapi.ideal.house/product-import/products/status?shopId=<SHOP_ID>
Параметры запроса#
| Поле | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
shopId | string | Да | Максимум 64 символов | Shop ID, использованный при отправке партии. |
Пример cURL#
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, затем повторите попытку, как описано ниже. |
Завершенное задание с ошибкой на уровне элемента#
{
"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 означает, что рабочий процесс партии завершён; это не означает, что все товары были обработаны успешно. Ошибки на уровне элементов не останавливают другие товары в той же партии.