상품 조회

get
https://api.imweb.me/v2/shop/products/
{상품번호}
상품번호를 입력하지 않으면 전체 상품 목록을 조회합니다.
상품 목록 요청 데이터
항목
타입
설명
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 형식에 맞는 데이터를 전달해주세요.
디지털 상품(Dgital Data)
회원그룹 이용권 상품(Subscribe Data)
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
미성년자 구매 제한

항목	타입	설명
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 형식에 맞는 데이터를 전달해주세요. 디지털 상품(Dgital Data) 회원그룹 이용권 상품(Subscribe Data)
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

항목	타입	설명
use_limit	Boolean	다운로드 한도 설정
period	Integer	기간 제한
maximum	Integer	횟수 제한

항목	타입	설명
group_code	String	대상 그룹 코드
period	Integer	그룹 유지 기간(일)

항목	타입	설명
type	String	적립금 설정 타입 common: 기본 설정을 따름 individual: 개별 적립금 설정
value_type	String	적립금 적립 단위 percent: 퍼센트 price: 통화 단위
value	String	적립금 값 적립금 단위가 퍼센트일 경우 백분율로 계산

항목	타입	설명
group_type	String	할인적용대상 회원+비회원 회원 그룹 명
dc_price	String	할인 금액 단위가 퍼센트일 경우 백분율로 계산
dc_type	String	할인금액 단위 percent: 퍼센트 price: 통화 단위

항목	타입	설명
stock_use	Boolean	재고 사용여부
stock_unlimit	Boolean	재고 소진 후 주문 가능 여부
stock_no_option	Integer	상품 재고 수량
sku_no_option	Integer	상품 재고번호(SKU)

항목	타입	설명
new	Boolean	뱃지 - 신상품 여부
best	Boolean	뱃지 - 베스트 여부
md	Boolean	뱃지 - MD 추천 여부
hot	Boolean	뱃지 - 주문폭주 여부

항목	타입	설명
seo_title	String	SEO 제목
seo_description	String	SEO 설명
seo_access_bot	Boolean	SEO 검색엔진 접근 제외 유무

항목	타입	설명
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	주문제작 여부

항목	타입	설명
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 modified 1yr ago