🎮RIOT API 분석 프로젝트(1) - API 신청 및 구조 확인

RIOT API 분석 프로젝트

✅ 배경 : API를 활용해 DB 구축 및 운영 경험을 해보고 싶었다 

✅ 목적 : RIOT LOL API를 활용해 아이언,브론즈,실버 구간의 실제 티어를 확인 가능한 웹 서비스 만들기

✅ 기간 : 2024.08.25 ~ 2024.09.22 (예정)

✅ 인원 : 2명

✅ 역할 : API를 활용해 아이언, 브론즈,실버 구간의 최근 10판 기록 DB 구축

✅ 프로세스 : python을 활용해 api 호출 및 DB 생성,

                       SQL 쿼리문을 활용해 데이터 추출 및 가공,

                       Tableau를 활용해 DB 지표 대시보드 생성,

                       Javascript를 활용하여 웹페이지 구현

---

RIOT API 신청

Riot Developer Portal (riotgames.com)

RIOT 개발자 포탈에 들어가서 API를 신청해야 한다.

이 화면은 24시간만 사용할 수 있는 API 발급키 화면이기에 

프로젝트로 두고 두고 쓰려면 REGISTER PRODUCT를 클릭하여 API키를 발급 받아야 한다.

 

 

PRODUCTION API KEY 는 큰 규모 프로젝트에서 하라고 나와있다.

근데 신청해도 발급 하는데 엄청 오래 걸린다는 글을 굉장히 많이 봤기에 PERSONAL API KEY를 발급 받기로 했다.

 

 

해당 정보를 기입하고 나면 바로 키가 발급 된다.

 

 

 

 

API 형태 확인하기

RIOT LOL API 파일이 어떻게 되어있는지 확인하기 위해서 설명들을 찾아 보았다.

[RIOT API 기능 모음]

ACCOUNT-V1

• 해당 유저(검색 대상) 관련된 정보를 반환

CHAMPION-MASTERY-V4

• 해당 유저(검색 대상)의 챔피언 숙련도를 오름차순으로 반환

CHAMPION-V3

• 현재 게임에서 무료로 사용할수 있는 챔피언, 신규 유저들이 사용 가능한 챔피언과 신규유저의 max level 을 반환 (신규유저의 max level은 10으로 고정 되어있는데, 이 의미는 신규 유저의 경우, 10레벨까지만 무료 챔피언을 주겠다는 의미이다.)

CLASH-V1

• LOL의 팀 토너먼트 모드인 격전과 관련된 게임/유저 정보를 반환

LEAGUE-EXP-V4

• 랭크(Solo, 자유)에 티어별의 소환사정보를 반환

LEAGUE-V4

특정 게임/리그에 속해 있는 유저들의 티어 정보들을 반환한다.

LOL-STATUS-V3

• LOL-STATUS-V4의 이전 버전 API (2020년 12월 11일까지 제공하였음)

LOL-STATUS-V4

• 현 플랫폼의 정보(Window, mac, android, ios 등)를 반환 (+지역별 업데이트가 필요한지를 체크)

MATCH-V4

• 특정 게임에 대한 모든 게임정보(게임 내용과 관련된 200가지 항목)들을 반환 (2021년 8월 23일 까지만 제공 이후에는 MATCH-V5로 확인)

MATCH-V5

• 특정 게임에 대한 모든 게임정보(게임 내용과 관련된 200가지 항목)들을 반환

SPECTATOR-V4

• 해당 유저(검색 대상)가 진행중인 게임정보를 반환

SUMMONER-V4

• 해당 유저(검색 대상)의 정보를 반환
  Riot API를 쓰기 위해서는 account id, puuid 등이 필요한데 여기서 확인 가능

THIRD-PARTY-CODE-V4

• 해당 유저(검색 대상)를 통하여 third party code를 반환

TOURNAMENT-STUB-V4

• 롤드컵과 같은 토너먼트와 관련된 API이며 production key로만 접근 가능

TOURNAMENT-V4

• 롤드컵과 같은 토너먼트와 관련된 API이며 production key로만 접근 가능

TFT (롤토체스)

TFT-LEAGUE-V1

• 특정 리그의 순위, 티어, LP 등을 조회할 수 있습니다.

TFT-SUMMONER-V1

• 특정 유저의 TFT 전적, 승률, 시즌 기록 등을 조회할 수 있습니다.

TFT-STATUS-V1

• TFT 패치 버전의 유닛, 아이템, 조합 등의 데이터를 제공합니다.

TFT-MATCH-V1

• 특정 TFT 매치의 상세 정보, 플레이어 정보, 팀 정보, 순위 등을 제공합니다.

---

여기서 내가 필요한 API 카테고리는 LEVEL-EXP-V4 / MATCH-V5 / SUMMONER-V4 3개이다.

 

 

 

필요한 데이터 구조화

LEVEL-EXP-V4  API를 누르면 해당 정보가 나온다.

내가 여기서 필요한 건 summonerID다.

 

SUMMONER-V4 API를 열면 id(summonerID)와puuid가 나온다. 

 

아래로 내려보면 encryptedSummonerId를 입력 하라고 되어 있다.

LEVEL-EXP-V4  API에서 summonerID를 뽑아와서 해당 데이터를 다시 SUMMONER-V4 API에 넣어서 puuid를 호출해야 한다.

 

 

MATCH-V5 API를열면 puuid를 입력하게 되어있다.

SUMMONER-V4 API에서 뽑아온 puuid를 다시 입력해서 게임 관련 데이터를 호출해야 한다.  

 

 

 

구조화 하면 다음과 같다