홈 > 개발가이드 > 카테고리정보

개요

이씨플라자 상품 카테고리를 기준으로 검색할 수 있습니다.

요청주소

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

요청메소드

GET, POST

요청변수

항목명 설명 샘플데이터
client_id string (필수) 발급받은 apikey 2f4b17d54d3cc4d3c8fcXXXXXXXXXXXXXXXXXXXX
client_secret string (필수) 발급받은 apikey secret f1510b6813a9721b7716XXXXXXXXXXXXXXXXXXXX
access_token string
(web용 api 경우 필수)
일회성 access token de785eecc25ca1d1bcd6XXXXXXXXXXXXXXXXXXXX
q string 검색조건
categoryno : 카테고리 아이디
categoryname : 카테고리명
categoryno:02;;categoryname:machine
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
항목명 설명
categoryid integer 카테고리아이디
categoryname string 카테고리명
- 결과 예제 : json
{
	total_count: 4,
	data: [
		{
			categoryname: "Other Motorcycle Electrical Systems",
			categoryid: 101692
		},
		{
			categoryname: "Other Electrical Instruments",
			categoryid: 13079
		},
		{
			categoryname: "Truck Electrical System",
			categoryid: 12971
		},
		{
			categoryname: "Motorcycle Electrical System",
			categoryid: 12946
		}
	]
}
- 결과 예제 : xml
<ecplaza_api>
	<total_count>23</total_count>
	<data>
		<item>
			<categoryname>"Other Motorcycle Electrical Systems"</categoryname>
			<categoryid>101692</categoryid>
		</item>
		<item>
			<categoryname>"Other Electrical Instruments"</categoryname>
			<categoryid>13079</categoryid>
		</item>
		<item>
			<categoryname>"Truck Electrical System"</categoryname>
			<categoryid>12971</categoryid>
		</item>
		<item>
			<categoryname>"Motorcycle Electrical System"</categoryname>
			<categoryid>12946</categoryid>
		</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. 검색 관련 파라미터가 없거나 잘못됨