모바일 앱 순위/분석 : 게볼루션

게볼루션 모바일게임&앱 순위 API (ver 1.1)

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

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

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

1. 이용안내

1.1 이용 절차

01.로그인
02.인증키 조회
03.개발하기
04.적용하기

인증키 조회 샘플(XML)

1.2 순위API 장점

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

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

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

1.4 권장사항(선택사항)

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

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

2.1 기본사항

Service API명	모바일 게임/앱/전체 순위조회
API 호출 결과 타입	XML
인증방법	인증키
스토어	구글플레이, 애플 앱스토어

2.2 Request URL

URL	Method
http://api.gevolution.co.kr/rank/xml/	GET

2.3 Request Parameters

이름	Type	필수여부	기본값	설명
aCode	string	Y	-	발급된 계정의 인증키
market	string	Y	g	g:구글플레이, a:애플 앱스토어
appType	string	Y	game	game:게임, app:일반앱, all:전체(게임+일반앱)
rankType	int	Y	1	1:무료, 2:유료,3:매출,4:신규무료,5:신규유료
rank	int	Y	10	1~OO위까지 출력 (max:100)

- 파라메터 이름과 값은 대.소문자를 구분하지 않습니다.
- rankType, rank 파라미터의 값은 숫자(정수)로 전송하셔야 합니다.
- 게시된 파라미터의 값이 올바르지 않거나 범위를 초과하면 명시된 기본값의 데이터가 반환됩니다.
- 애플 앱스토어의 경우 신규 (무료&유료) 순위 정보를 제공하지 않으며 신규순위 정보는 구글플레이만 가능합니다.

Sample URL
http://api.gevolution.co.kr/rank/xml/?aCode=HIJK372129&market=g&appType=game&rankType=1&rank=20
설명 : 구글플레이 게임 무료인기 순위 1~20위

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

응답 성공시 출력되는 필드

이름	Type	설명
aid	string	해당 게임의 게볼루션 고유값
ranking	integer	순위
lastWeek	integer	1주전 순위 (단, 0 : 신규게임, 1000 : 100위권 밖에서 재진입)
gameName	string	게임 이름
publisher	string	퍼블리셔 이름
iconUrl	string	앱 대표 아이콘의 이미지 URL (단, noData : 이미지 정보 없음)
gevolUrl	string	게볼루션의 앱 상세페이지 URL (PC Web)
gevolMUrl	string	게볼루션의 앱상세페이지 URL (Mobile Web) (단, noData : URL 정보 없음)
googleUrl	string	구글플레이 다운로드(상세페이지) URL (단, noData : URL 정보 없음)
appleUrl	string	애플 앱스토어 다운로드(상세페이지) URL (단, noData : URL 정보 없음)
rating	integer	앱 평가 점수 (0~100) (단, 0 : 평가점수 정보 없음)
movieUrl	string	앱 홍보동영상 URL (youtube) (단, noData : 동영상 URL 정보 없음)
cafeUrl	string	공식카페 URL (단, noData : 카페 정보 없음)

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

Code	설명
901	등록되지 않은 인증키입니다.
902	사용할 수 없는 인증키입니다.
903	서비스에 대한 호출 권한이 없습니다.
904	잘못된 형식의 호출 parameter입니다.
910	순위정보가 존재하지 않습니다.
911	잘못된 형식의 호출 parameter입니다.
912	parameter 값이 존재하지 않습니다.
920	정의되지 않은 오류가 발생하였습니다.

1	브롤스타즈
2	달빛조각사
3	사피망 뉴맞고

1	달빛조각사
2	세븐나이츠
3	리니지M