무역기업이 수출입하고자 조건에 따르는 바이어정보를 오퍼명, 키워드, 카테고리를 기준으로 검색할 수 있습니다.
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 이하 |
항목명 | 값 | 설명 |
---|---|---|
directoryid | integer | 아이디 |
companyname | string | 업체명 |
itemnames | string | 취급품목 |
phone | string | 전화번호 |
address | string | 주소 |
contactname | string | 담당자명 |
country | string | 국가코드 |
countryname | string | 국가명 |
{ 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" } ] } ] }
<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. | 검색 관련 파라미터가 없거나 잘못됨 |