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

개요

무역기업이 수출하고자 하는 자사 제품 정보를 제품명, 키워드, 카테고리를 기준으로 검색할 수 있습니다.

요청주소

https://api.ecplaza.net/apis/2/product

요청메소드

GET, POST

요청변수

항목명 설명 샘플데이터
client_id string (필수) 발급받은 apikey 2f4b17d54d3cc4d3c8fcXXXXXXXXXXXXXXXXXXXX
client_secret string (필수) 발급받은 apikey secret f1510b6813a9721b7716XXXXXXXXXXXXXXXXXXXX
access_token string
(web용 api 경우 필수)
일회성 access token de785eecc25ca1d1bcd6XXXXXXXXXXXXXXXXXXXX
q string 검색조건
productname : 상품명
companyname : 업체명
categoryid : 카테고리 ID
productname:mp3;;companyname:ecplaza
ordercolumn string : 기본값 registdate 정렬항목
registdate : 등록일자
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
항목명 설명
catalogid integer 제품 ID
productname string 제품명
description string 제품 설명
specipication string 제품 스펙
keywords string 키워드
categoryid integer 카테고리
categoryname string 카테고리명
moq integer 최소주문수량
sampleprice string 샘플가격
smallimage string 작은 이미지 url
largeimage string 큰 이미지 url
registdate string 등록일
companyname string 회사명
ceoname string 대표자명
phone string 전화번호
fax string 팩스번호
address string 주소
membername string 담당자명
homepage string 홈페이지 url
detailpageurl string ECPlaza url
inquiryurl string 인콰이어리 url
- 결과 예제 : json
{
	total_count: 1,
	data: [
		{
			smallimage: "http://img.ecplaza.com/my/xxxxxx/xxxxxx.gif",
			catalogid: xxxxxx,
			inquiryurl: "http://www.ecplaza.net/InquiryBox/InquiryBox.do?cmd=showForm&clickfrom=C&id=xxxxxx",
			phone: "86-xxxx-xxxx-xxxx",
			categoryname: "Other Musical Instruments & Accessories",
			fax: "86-xxxx-xxxx-xxxx",
			registdate: "2006/01/23T12:59:44",
			moq: "50pcs",
			largeimage: "http://img.ecplaza.com/my/xxxxxx/xxxxxx.jpg",
			companyname: "ECPlaza",
			homepage: "http://www.ecplaza.net",
			categoryid: xxxxxx,
			address: "A808 xxxxxx, xxxxxx, xxxxxx",
			productname: "MP3 Watch(1700-22)",
			ceoname: "Hong gil dong",
			detailpageurl: "http://www.ecplaza.net/product/MP3 Watch(1700-22)--78771-xxxxxx.html",
			membername: "Hong gil dong",
			sampleprice: 0,
			description: "This ball-point pen is a high-definition video recorder with built-in memory.",
			specipication: "Available flash memory size: 1GB , 2GB",
			keywords: [
				{
					keyword: "mp3 Voice Recorder watch"
				}
			]
		}
	]
}
- 결과 예제 : xml
<ecplaza_api>
	<total_count>4508</total_count>
	<data>
		<item>
			<smallimage>"http://img.ecplaza.com/my/xxxxxx/xxxxxx.gif"</smallimage>
			<catalogid>xxxxxx</catalogid>
			<inquiryurl>"http://www.ecplaza.net/InquiryBox/InquiryBox.do?cmd=showForm&clickfrom=C&id=xxxxxx"</inquiryurl>
			<phone>"86-xxxx-xxxx-xxxx"</phone>
			<categoryname>"Other Musical Instruments & Accessories"</categoryname>
			<fax>"86-xxxx-xxxx-xxxx"</fax>
			<registdate>"2006/01/23T12:59:44"</registdate>
			<moq>"50pcs"</moq>
			<largeimage>"http://img.ecplaza.com/my/xxxxxx/xxxxxx.jpg"</largeimage>
			<companyname>"ECPlaza"</companyname>
			<homepage>"http://www.ecplaza.net"</homepage>
			<categoryid>2268</categoryid>
			<address>"A808 xxxxxx, xxxxxx, xxxxxx"</address>
			<productname>"MP3 Watch(1700-22)"</productname>
			<ceoname>"Hong gil dong"</ceoname>
			<detailpageurl>"http://www.ecplaza.net/product/MP3 Watch(1700-22)--78771-xxxxxx.html"</detailpageurl>
			<membername>"Hong gil dong"</membername>
			<sampleprice>"0"</sampleprice>
			<description>
				<![CDATA[:"This ball-point pen is a high-definition video recorder with built-in memory."]]>
			</description>
			<specipication>
				<![CDATA["Available flash memory size: 1GB , 2GB" ]]>
			</specipication>
			<keywords>
				<item>
					<keyword>"mp3 Voice Recorder watch"</keyword>
				</item>
			</keywords>
		</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. 검색 관련 파라미터가 없거나 잘못됨