가격비교

가격비교 상품을 조회하는 API입니다.

내 상품 목록 조회

get

본인 상점의 판매 중 상품을 itemId 내림차순으로 조회합니다.

목록이 비어 있어도 nextCursor가 반환될 수 있으며, nextCursor가 null이면 마지막 페이지입니다.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

nextCursorinteger · int64Optional

직전 응답의 nextCursor. 해당 itemId 미만부터 조회합니다

Example: 500096495

pageSizeinteger · int32Optional

한 번에 조회할 상품 수. 1~999 범위로 입력합니다

Default: 100Example: 100

Responses

200

모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)

application/json

resultTypestring · enumOptional

응답 결과 타입

Possible values:

get/api/v3/shopping-fep/price-compare/products/list

GET /api/v3/shopping-fep/price-compare/products/list HTTP/1.1
Host: shopping-fep.toss.im
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)

{
  "resultType": "SUCCESS",
  "error": {
    "errorCode": "INVALID_OAUTH_REQUEST",
    "reason": "text"
  },
  "success": {
    "items": [
      {
        "itemId": 500096495,
        "salePrice": 29900,
        "name": "나이키 에어맥스 270 블랙",
        "productName": "나이키 에어맥스",
        "optionName": "블랙/270",
        "brandName": "나이키",
        "imageUrl": "https://example.com/item-thumbnail.jpg",
        "detailImageUrls": [
          "https://example.com/detail-image.jpg"
        ],
        "detailHtmlUrls": [
          "https://example.com/detail.html"
        ]
      }
    ],
    "nextCursor": 500096495
  }
}