게볼루션에서 제공하는 구글플레이 및 애플 앱스토어 순위를 웹(혹은 앱) 환경에서 구현하기 위한 가이드입니다. 게볼루션 모바일앱임&앱 순위 API (이하 순위API)를 사용하기 위해서는 게볼루션 계정으로 로그인을 하신 후 인증키를 발급받으셔야 합니다.
인증키 발급은 누구나 신청이 가능하며 발급에 특별한 제한사항이 없습니다.
- 2016-11-04 : 전체앱순위, 일반앱 순위 추가제공
01.로그인
02.인증키 조회
03.개발하기
04.적용하기
- 구글플레이와 앱스토어 순위정보를 활용함으로써 어디서든 신뢰할 수 있는 객관적인 데이터입니다. - 여러분의 서비스에 모바일게임 순위정보를 삽입하거나 모바일게임/앱과 관련된 다양한 애플리케이션을 개발하실 수 있습니다. - 구글플레이 및 애플 앱스토어의 최신 순위정보 확인이 가능합니다. (매일 업데이트) - 필요에 따라 자유롭게 순위 서비스를 확장하여 나만의 컨덴츠로 제작할 수 있습니다. - 누구나 자유롭게 무료로 연동이 가능합니다. - 국내 혹은 전 세계에서 유일하게 연동 가능한 순위 API입니다.
- 국내(한국)의 순위 정보만 연동이 가능합니다. - 순위는 100위까지만 제공하며 100위 미만일 경우 존재하는 랭킹까지만 제공됩니다. - 현재의 순위 정보만 연동이 가능합니다.(매일 오전 10:50 ~ 11:20 기준으로 업데이트 됩니다.) - 연동된 순위정보를 본인의 서비스 DB에 주기적으로 저장하는 것을 자제해주세요. (최근 2주까지의 데이터 저장은 허용) - 과도한 부하를 방지하기 위해 일 처리한도를 10,000건으로 제한합니다. (초과시 별도로 요청가능)
- 출처를 [게볼루션]으로 명시하는 것을 권장합니다. - 게임상세 정보 URL을 게볼루션 상세페이지로 이동하기를 권장합니다. (하단의 Response Fields -> gevolUrl)
| Service API명 | 모바일 게임/앱/전체 순위조회 |
|---|---|
| API 호출 결과 타입 | XML |
| 인증방법 | 인증키 |
| 스토어 | 구글플레이, 애플 앱스토어 |
| URL | Method |
|---|---|
| http://api.gevolution.co.kr/rank/xml/ | GET |
| 이름 | 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) |
| Sample URL |
|---|
| http://api.gevolution.co.kr/rank/xml/?aCode=HIJK372129&market=g&appType=game&rankType=1&rank=20 |
| 설명 : 구글플레이 게임 무료인기 순위 1~20위 |
<?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>
| 이름 | 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 | 정의되지 않은 오류가 발생하였습니다. |
