게볼루션에서 제공하는 구글플레이 및 애플 앱스토어 순위를 웹(혹은 앱) 환경에서 구현하기 위한 가이드입니다.
게볼루션 모바일앱임&앱 순위 API (이하 순위API)를 사용하기 위해서는 게볼루션 계정으로 로그인을 하신 후 인증키를 발급받으셔야 합니다.

인증키 발급은 누구나 신청이 가능하며 발급에 특별한 제한사항이 없습니다.

- 2016-11-04 : 전체앱순위, 일반앱 순위 추가제공

1. 이용안내

1.1 이용 절차

1. 01.로그인

2. 02.인증키 조회

3. 03.개발하기

4. 04.적용하기

1.2 순위API 장점

- 구글플레이와 앱스토어 순위정보를 활용함으로써 어디서든 신뢰할 수 있는 객관적인 데이터입니다.
- 여러분의 서비스에 모바일게임 순위정보를 삽입하거나 모바일게임/앱과 관련된 다양한 애플리케이션을 개발하실 수 있습니다.
- 구글플레이 및 애플 앱스토어의 최신 순위정보 확인이 가능합니다. (매일 업데이트)
- 필요에 따라 자유롭게 순위 서비스를 확장하여 나만의 컨덴츠로 제작할 수 있습니다.
- 누구나 자유롭게 무료로 연동이 가능합니다.
- 국내 혹은 전 세계에서 유일하게 연동 가능한 순위 API입니다.

1.3 순위API 연동 제한 및 유의사항

- 국내(한국)의 순위 정보만 연동이 가능합니다.
- 순위는 100위까지만 제공하며 100위 미만일 경우 존재하는 랭킹까지만 제공됩니다.
- 현재의 순위 정보만 연동이 가능합니다.(매일 오전 10:50 ~ 11:20 기준으로 업데이트 됩니다.)
- 연동된 순위정보를 본인의 서비스 DB에 주기적으로 저장하는 것을 자제해주세요. (최근 2주까지의 데이터 저장은 허용)
- 과도한 부하를 방지하기 위해 일 처리한도를 10,000건으로 제한합니다. (초과시 별도로 요청가능)

1.4 권장사항(선택사항)

- 출처를 [게볼루션]으로 명시하는 것을 권장합니다.
- 게임상세 정보 URL을 게볼루션 상세페이지로 이동하기를 권장합니다. (하단의 Response Fields -> gevolUrl)

1.5 순위API 사용시 주의사항

- 게볼루션에서 제공하는 순위 API의 순위정보는 실제 구글플레이/애플 앱스토어의 순위와 다를 수 있습니다.
- 해당 순위 제공으로 인한 법적 책임에 대해서는 게볼루션에서는 책임지지 않습니다.
- 해당 순위 정보는 참고용으로 이용하시길 권장합니다.

2. 모바일게임/앱/전체 순위 조회 API

2.1 기본사항

2.2 Request URL

2.3 Request Parameters

2.4 Response Samples

응답 성공

<?xml version="1.0" encoding="utf-8" ?>
<response>
	<header>
		<resultCode>0000</resultCode>
		<resultMsg>OK</resultMsg>
	</header>
	<items>
		<item>
			<aid>3be668103bee1f603beb09403be4dd003bee1f60</aid>
			<ranking>1</ranking>
			<lastWeek>2</lastWeek>
			<gameName>보글보글 for Kakao</gameName>
			<publisher>(주)스코넥 엔터테인먼트</publisher>
			<iconUrl>http://upload.gevolution.co.kr/www/201411/41948z4886111111.png</iconUrl>
			<gevolUrl>-</gevolUrl>
			<gevolMUrl>-</gevolMUrl>
			<googleUrl>-</googleUrl>
			<appleUrl>-</appleUrl>
			<rating>-</rating>
			<movieUrl>NoData</movieUrl>
			<cafeUrl>NoData</cafeUrl>
		</item>
		<item>
			<aid>3beb09403befaa703beb09403be7f3203bee1f60</aid>
			<ranking>2</ranking>
			<lastWeek>18</lastWeek>
			<gameName>던전앤스피릿 for Kakao</gameName>
			<publisher>(주)추콩코리아</publisher>
			<iconUrl>http://upload.gevolution.co.kr/www/201411/41955z4583680556.png</iconUrl>
			<gevolUrl>-</gevolUrl>
			<googleUrl>-</googleUrl>
			<appleUrl>-</appleUrl>
			<rating>-</rating>
			<movieUrl>NoData</movieUrl>
			<cafeUrl>NoData</cafeUrl>
		</item>
		..... 중략.......
	</items>
</response>
	

응답 실패

<?xml version="1.0" encoding="utf-8" ?>
<response>
	<header>
		<resultCode>E901</resultCode>
		<resultMsg>AUTH FAILED.</resultMsg>
	</header>
</response>
	

2.5 Response Fields

응답 성공시 출력되는 필드

응답 실패시 에러코드(예외처리)