ECPlaza Open API

홈 > 개발가이드 > 오퍼정보

개요

무역기업이 수출입하고자 조건에 따르는 오퍼 정보를 제품명, 키워드, 카테고리를 기준으로 검색할 수 있습니다.

요청주소

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

요청메소드

GET, POST

요청변수

항목명	값	설명	샘플데이터
client_id	string (필수)	발급받은 apikey	2f4b17d54d3cc4d3c8fcXXXXXXXXXXXXXXXXXXXX
client_secret	string (필수)	발급받은 apikey secret	f1510b6813a9721b7716XXXXXXXXXXXXXXXXXXXX
access_token	string (web용 api 경우 필수)	일회성 access token	de785eecc25ca1d1bcd6XXXXXXXXXXXXXXXXXXXX
q	string (필수)	검색조건 categoryid : 카테고리아이디 companyname : 회사명 subject : 오퍼 제목 note : 제안 내용 offertype : 오퍼 종류(sell/buy)	subject:mp3 subject:mp3;;companyname:ecplaza subject:mp3;;offertype:sell subject:mp3;;offertype:sell
ordercolumn	string : 기본값 registdate	정렬항목 categoryid : 카테고리아이디 companyname : 회사명 registdate : 등록일	registdate
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

항목명	값	설명
offerid	integer	오퍼 ID
subject	string	제목
note	string	제안 내용
keywords	array	키워드
categoryid	integer	카테고리아이디
categoryname	string	카테고리명
registdate	string	등록일
smallimage	string	작은 이미지 url
largeimage	string	큰 이미지 url
companyname	string	회사명
ceoname	string	대표자명
phone	string	전화번호
fax	string	팩스번호
address	string	주소
membername	string	담당자명
homepage	string	홈페이지 url
offertype	string	오퍼종류
detailpageurl	string	Offer 상세 페이지 url
inquiryurl	string	인콰이어리 url

- 결과 예제 : json

{
	total_count: 83,
	data: [
		{
			smallimage: "http://image.ecplaza.net/global/tonta/images/gCommon/xxxxxxx.gif",
			phone: "82-2-xxxx-xxxx",
			inquiryurl: "http://www.ecplaza.net/InquiryBox/InquiryBox.do?cmd=showForm&clickfrom=M&id=xxxxxxx",
			fax: "82-2-xxxx-xxxx",
			subject: "MP3 player",
			registdate: "1999/06/26T11:56:19",
			note: "We are looking for an importer or an distributor who will import' the most advanced MP3 player on OEM basis or on manufacturer`s brand. Please contact me immediately for starting a long term cooperation. ",
			companyname: "ECPlaza",
			largeimage: "http://image.ecplaza.net/global/tonta/images/gCommon/xxxxxxx.gif",
			homepage: "http://www.ecplaza.net",
			offerid: xxxxxxx,
			ecplazaurl: "xxxxxxx",
			offertype: "sell",
			address: "64,2-ga,xxxxxxx-dong,xxxxxxx-gu",
			ceoname: "",
			detailpageurl: "http://www.ecplaza.net/trade-leads-seller/MP3 player--xxxxxxx.html",
			membername: "Hong gil dong",
			keywords: [ ]
		}
	]
}

- 결과 예제 : xml

<ecplaza_api>
	<total_count>83</total_count>
	<data>
		<item>
			<smallimage>"http://image.ecplaza.net/global/tonta/images/gCommon/xxxxxxx.gif"</smallimage>
			<phone>"82-2-xxxx-xxxx"</phone>
			<inquiryurl>"http://www.ecplaza.net/InquiryBox/InquiryBox.do?cmd=showForm&clickfrom=M&id=xxxxxxx"</inquiryurl>
			<fax>"82-2-xxxx-xxxx"</fax>
			<subject>"MP3 player"</subject>
			<registdate>"1999/06/26T11:56:19"</registdate>
			<note>
				<![CDATA["We are looking for an importer or an distributor who will import' the most advanced MP3 player on OEM basis or on manufacturer`s brand. Please contact me immediately for starting a long term cooperation. "]]>
			</note>
			<companyname>"ECplaza"</companyname>
			<largeimage>"http://image.ecplaza.net/global/tonta/images/gCommon/xxxxxxx.gif"</largeimage>
			<homepage>"http://www.ecplaza.net"</homepage>
			<offerid>xxxxxxx</offerid>
			<ecplazaurl>"xxxxxxx"</ecplazaurl>
			<offertype>"Selling"</offertype>
			<address>"64,2-ga,xxxxxxx-dong,xxxxxxx-gu"</address>
			<ceoname>""</ceoname>
			<detailpageurl>"http://www.ecplaza.net/trade-leads-seller/MP3 player--xxxxxxx.html"</detailpageurl>
			<membername>"Hong gil dong"</membername>
			<keywords></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.	검색 관련 파라미터가 없거나 잘못됨

API 이용안내

개발가이드

통합검색

오퍼정보

개요

요청주소

요청메소드

요청변수

출력결과

data

- 결과 예제 : json

- 결과 예제 : xml

에러코드

API 이용안내

개발가이드

Open API 이용약관

개인정보취급방침