홈 > 개발가이드 > PowerBMS 제품정보정보

개요

powerBMS 사이트의 제품 정보를 제품명, 상세설명, 카테고리를 기준으로 검색할 수 있습니다.

요청주소

https://api.ecplaza.net/apis/1/product_bms

요청메소드

GET, POST

요청변수

항목명 설명 샘플데이터
client_id string (필수) 발급받은 apikey 2f4b17d54d3cc4d3c8fcXXXXXXXXXXXXXXXXXXXX
client_secret string (필수) 발급받은 apikey secret f1510b6813a9721b7716XXXXXXXXXXXXXXXXXXXX
access_token string
(web용 api 경우 필수)
일회성 access token de785eecc25ca1d1bcd6XXXXXXXXXXXXXXXXXXXX
q string 검색조건
productname : 상품명
categoryid : 카테고리 ID
categoryname : 카테고리명
description : 설명
productname:mp3;;description:mp3
ordercolumn string : 기본값 id 정렬항목
productname : 상품명
categoryname : 카테고리명
orderby string : 기본값 desc 정렬순서
asc | desc
asc
pageno integer : 기본값 1 페이지 번호 1
output string : 기본값 json 결과 형식
xml | json
json
result integer : 기본값 10 한 페이지당 결과 수
1 ~ 30
10
dataType string jsonp 사용시 설정 jsonp
jsonp string jsonp 사용시 설정 callback

출력결과

항목명 설명
total_count integer 전체 상품 수
data - 제품 정보 node, 아래 data 이하
data
항목명 설명
id integer 제품 ID
name string 제품명
description string 제품 설명
model string 모델명
hscode string HSCODE
category_id integer 카테고리
category_name string 카테고리명
unit_price integer 가격
min_supply_count integer 최소제공수량
max_supply_count integer 최대제공수량
images array 이미지 url
- 결과 예제 : json
{
	total_count: 1,
	data: [
		{
			code: "W715862",
			hscode: "3307302000",
			min_supply_count: 10,
			category_name: "목욕용품",
			max_supply_count: 100,
			category_id: 409,
			name: "해피바스 해피바스 정말 촉촉한 타입 바디워시 900g",
			description: "해피바스 정말 촉촉한 타입 바디워시 900g 후르츠 워터가 촉촉하게 바디로션 바디워시 촉촉한바디로션 수분워시 바디케어",
			model: "해피바스 해피바스 정말 촉촉한 타입 바디워시 900g",
			id: 5758,
			unit_price: 7613,
			mptype: 1,
			images: [
				{
					image: "http://powerbms.com/xxxxx/xxxxxxxx.jpg"
				},
				{
					image: "http://powerbms.com/xxxxx/xxxxxxxx.jpg"
				}
			]
		}
	]
}
- 결과 예제 : xml
<ecplaza_api>
	<total_count>1</total_count>
	<data>
		<item>
			<code>"W715862"</code>
			<hscode>"3307302000"</hscode>
			<min_supply_count>10</min_supply_count>
			<category_name>"목욕용품"</category_name>
			<max_supply_count>100</max_supply_count>
			<category_id>409</category_id>
			<name>"해피바스 해피바스 정말 촉촉한 타입 바디워시 900g"</name>
			<description>
				<![CDATA[:"해피바스 정말 촉촉한 타입 바디워시 900g 후르츠 워터가 촉촉하게 바디로션 바디워시 촉촉한바디로션 수분워시 바디케어"]]>
			</description>
			<model>"해피바스 해피바스 정말 촉촉한 타입 바디워시 900g"</model>
			<id>5758</id>
			<unit_price>7613</unit_price>
			<images>
				<item>
					<image>"http://powerbms.com/xxxxx/xxxxxxxx.jpg"</image>
				</item>
				<item>
					<image>"http://powerbms.com/xxxxx/xxxxxxxx.jpg"</image>
				</item>
			</images>
		</item>
	</data>
</ecplaza_api>

에러코드

에러코드 (error) 메세지 (error_message) 설명
unauthorized_client The client is not authorized to request an access token using this method. 인증되지 않은 api
invalid_client Client authentication failed 인증 실패
invalid_api_type API type is incorrect. Check the api type on the ECPlaza Open API site. 발급받은 api 종류와 맞지 않는 데이터 요청
no_exist_api No exist api. Check the api status on the ECPlaza Open API site. 존재하지 않는 api
exceeded_api_key API Key number of requests has been exceeded. Check the api type on the ECPlaza Open API site. 요청 횟수 만
invalid_request The request is missing a required parameter, includes an invalid parameter value, includes a parameter more than once, or is otherwise malformed. Check the "redirect_uri" parameter. 잘못된 요청
no_exist_access_token Access token is not exist. Check the access token. 필수요청 파라미터가 없음(access token)
expired_token The access token is expired. Check the access token. access token 만료
query_nothing q parameter is required. Check the params. 검색 관련 파라미터가 없거나 잘못됨