가져오기 상태 조회#

상태 엔드포인트는 스토어의 현재 또는 가장 최근 가져오기 작업을 반환합니다.

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 상태는 배치 작업 흐름이 끝났다는 뜻이며 모든 상품이 성공했다는 의미는 아닙니다. 항목별 실패는 동일한 배치의 다른 상품 처리를 중단시키지 않습니다.