홈 > 개발가이드 > 바이어정보

개요

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

요청주소

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

요청메소드

GET, POST

요청변수

항목명 설명 샘플데이터
client_id string (필수) 발급받은 apikey 2f4b17d54d3cc4d3c8fcXXXXXXXXXXXXXXXXXXXX
client_secret string (필수) 발급받은 apikey secret f1510b6813a9721b7716XXXXXXXXXXXXXXXXXXXX
access_token string
(web용 api 경우 필수)
일회성 access token de785eecc25ca1d1bcd6XXXXXXXXXXXXXXXXXXXX
q string 검색조건
itemname : 취급품목
companyname : 업체명
itemname: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
항목명 설명
directoryid integer 아이디
companyname string 업체명
itemnames string 취급품목
phone string 전화번호
address string 주소
contactname string 담당자명
country string 국가코드
countryname string 국가명
- 결과 예제 : json
{
	total_count: 813,
	data: [
		{
			countryname: "Korea (South)",
			phone: "031-xxxx-xxxx",
			directoryid: "xxxxxx",
			contactname: "",
			address: "ECPlaza, 452-3, 1F Shinho Vilat, Sungnae-dong Gangdong-gu, Seoul, KOREA",
			companyname: "ECPlaza",
			country: "KR",
			itemnames: [
				{
					itemname: "10/100 BASE T PORT AGGREGATOR TAP"
				},
				{
					itemname: "10GHZ DPSK DEMODULATOR"
				}
			]
		}
	]
}
- 결과 예제 : xml
<ecplaza_api>
	<total_count>813</total_count>
	<data>
		<item>
			<countryname>"Korea (South)"</countryname>
			<phone>"031-xxxx-xxxx"</phone>
			<directoryid>xxxxxx</directoryid>
			<contactname>""</contactname>
			<address>"ECPlaza, 452-3, 1F Shinho Vilat, Sungnae-dong Gangdong-gu, Seoul, KOREA"</address>
			<companyname>"ECPlaza"</companyname>
			<country>"KR"</country>
			<itemnames>
				<item>
					<itemname>"10/100 BASE T PORT AGGREGATOR TAP"</itemname>
				</item>
				<item>
					<itemname>"10GHZ DPSK DEMODULATOR"</itemname>
				</item>
			</itemnames>
		</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. 검색 관련 파라미터가 없거나 잘못됨