상품 조회

상품번호를 입력하지 않으면 전체 상품 목록을 조회합니다.

GET https://api.imweb.me/v2/shop/products/{상품번호}

Path Parameters

NameTypeDescription

category

String

상품 카테고리 코드

prod_status

String

상품 상태

{
    // Response
}

상품 목록 요청 데이터

항목타입설명

prod_status

string

특정 상태의 상품을 조회할 때 입력합니다.

상품 상태 종류

  • sale: 판매중

  • soldout: 품절

  • nosale: 숨김

category

string

상품 카테고리 코드 상품 카테고리 조회

응답 데이터

기본 응답 데이터

항목타입설명

no

Integer

상품번호

prod_status

String

상품 상태

  • sale: 판매중

  • soldout: 품절

  • nosale: 숨김

categories

Array

카테고리 코드 목록

custom_prod_code

String

자체 상품코드

name

String

상품명

images

Array

이미지 파일 코드

image_url

Array

이미지 파일 URL

content

String

상세설명

simple_content

String

요약 설명

use_mobile_prod_content

Boolean

모바일 상세설명 사용 유무

mobile_content

String

모바일 상세 설명

prod_type

String

판매 방식 설정

  • normal: 일반 상품

  • digital: 디지털 상품세부 정보는 prod_type_data 참고

  • subscribe: 회원그룹 이용권세부 정보는 prod_type_data 참고

prod_type_data

Array

판매 방식 데이터

prod_type 형식에 맞는 데이터를 전달해주세요.

use_pre_sale

Boolean

판매기간 설정 여부

pre_sale_start_date

Integer

판매기간 시작일(Timestamp)

pre_sale_end_date

Integer

판매기간 종료일(Timestamp)

price

Float

상품가격

price_org

Float

할인 이전 가격

price_tax

Boolean

세금 포함 여부

price_none

Boolean

가격 없음 여부

point

Array

적립금 설정 (PointConfigData)

product_discount_options

Array

할인 사용 설정

  • coupon: 쿠폰

  • point: 적립금

  • shopping_group_dc: 쇼핑등급 할인

weight

Float

상품 무게

stock

Array

상품 재고 정보

옵션 재고 정보는 옵션 정보를 참고해주세요. (ProdStockConfigData)

origin

String

원산지

maker

String

제조사

brand

String

브랜드

badge

Array

뱃지 정보 (ProdBadgeData)

seo

Array

SEO 관련 정보 (ProdSeoData)

sync

Array

외부 연동용 정보(ProdSyncData)

etc

Array

기타설정 (ProdEtcData)

prodinfo

Array

상품정보제공고시

is_exist_options

String

상품의 옵션 유무

  • Y: 옵션이 존재

  • N: 단일 상품

is_mix

String

상품의 조합형 옵션 여부

  • Y: 조합형 옵션

  • N: 단일 옵션

add_time

Integer

상품 추가시간 Timestamp

edit_time

Integer

상품 최근 수정시간 Timestamp

prod_type_data - Digital Data

항목타입설명

use_limit

Boolean

다운로드 한도 설정

period

Integer

기간 제한

maximum

Integer

횟수 제한

prod_type_data - Subscribe Data

항목타입설명

group_code

String

대상 그룹 코드

period

Integer

그룹 유지 기간(일)

Point Config Data

항목타입설명

type

String

적립금 설정 타입

  • common: 기본 설정을 따름

  • individual: 개별 적립금 설정

value_type

String

적립금 적립 단위

  • percent: 퍼센트

  • price: 통화 단위

value

String

적립금 값

적립금 단위가 퍼센트일 경우 백분율로 계산

Period Discount Data

항목타입설명

group_type

String

할인적용대상

  • 회원+비회원

  • 회원

  • 그룹 명

dc_price

String

할인 금액

단위가 퍼센트일 경우 백분율로 계산

dc_type

String

할인금액 단위

  • percent: 퍼센트

  • price: 통화 단위

ProdStockConfig Data

항목타입설명

stock_use

Boolean

재고 사용여부

stock_unlimit

Boolean

재고 소진 후 주문 가능 여부

stock_no_option

Integer

상품 재고 수량

sku_no_option

Integer

상품 재고번호(SKU)

ProdBadge Data

항목타입설명

new

Boolean

뱃지 - 신상품 여부

best

Boolean

뱃지 - 베스트 여부

md

Boolean

뱃지 - MD 추천 여부

hot

Boolean

뱃지 - 주문폭주 여부

ProdSeoData Data

항목타입설명

seo_title

String

SEO 제목

seo_description

String

SEO 설명

seo_access_bot

Boolean

SEO 검색엔진 접근 제외 유무

ProdSyncData Data

항목타입설명

pay_product_name

String

네이버, 카카오 쇼핑 노출용 상품명

event_words

String

네이버 쇼핑 이벤트 문구

naver_category

String

네이버 쇼핑 카테고리 ID

product_flag

String

네이버 쇼핑 판매 방식

  • 소매

  • 도매

  • 렌탈

  • 대여

  • 할부

  • 예약판매

  • 구매대행

product_condition

String

네이버 쇼핑 상품상태

  • 신상품

  • 중고

  • 리퍼

  • 전시

  • 반품

  • 스크래치

import_flag

Boolean

해외구매대행 여부

parallel_import

Boolean

병행수입 여부

is_culture_benefit

Boolean

도서공연비 소득공제

order_made

Boolean

주문제작 여부

ProdEtcData Data

항목타입설명

minimum_purchase_quantity

Integer

최소 구매 수량

maximum_purchase_quantity

Integer

1회 구매 시 최대 수량

member_maximum_purchase_quantity

Integer

1인 구매 시 최대 수량

optional_limit_type

String

0원 선택옵션 구매 시 최대 구매수량 제한 타입

  • relative: 본상품 구매 수량만큼 구매 가능

  • limit: 최대 구매 수량 제한

  • unique: 1개만 구매 가능

optional_limit

Integer

0원 선택옵션 구매 시 최대 구매수량 - 최대 구매 수량 제한

use_unipass_number

String

개인통관고유부호 사용 설정

  • default: 기본 방법을 따름 (쇼핑 환경설정)

  • Y: 사용

  • N: 사용안함

adult

Boolean

미성년자 구매 제한

Last updated