[짧] 롤 API 가져오기

가끔 게임 분야에 관심있는 분들이 데이터분석 포트폴리오로 만들만 한 주제를 추천해달라고 하면 저는 riot API를 추천합니다. 대중성있고 리그오브레전드,룬테라, TFT 등 API도 다양하게 많이 제공해주기 때문입니다. 이번 글은 롤 API를 가져오는 핵심 Endpoint를 정리해보겠습니다.

---

1. riot api 로그인

https://developer.riotgames.com/app-type

Sign in with your Riot account

Product 등록입니다. 왼쪽은 Prouduction 레벨의 API 이며, 요청횟수가 더 많거나 더 많은 정보를 줍니다만, 승인 기간이 느리고 절차가 필요합니다. 우측 Personal API Key를 발급 받으시면 됩니다.

Personal 키의 경우 매번 갱신해야합니다. 또한 요청 횟수가 1초에 20건, 2분에 100건으로 제한되어있기 때문에 꾸준한 데이터 수집을 위해서는 반드시 배치형식의 데이터 수집을 고려해야합니다.

 

2. 핵심 API 3가지

보통 riot api라고하면 리그오브레전드 게임 내의 게임 정보에 대한 데이터를 생각합니다. 해당 데이터는 match - timeline api에 정보가 있습니다. 이 정보를 가져오려면 matchi id를 가져와야하고 또 이 match id를 구하려면 유저 id(puuid)가 필요합니다. 다음은 이 3가지 api를 cascading 하게 가져오기 위한 각 api의 구조입니다.

• Match-V5
  • 경로: /lol/match/v5/matches/{matchId}/timeline
  • 설명: 최종적으로 요청해야해하는 API - Match Timeline
  • 요청변수: matchid
  • 응답변수: 챔피언 1-10에 대한 puuid, 아이템, 스탯, 타임스탬프 등
  • 링크
• Match-V5
  • 경로: /lol/match/v5/matches/by-puuid/{puuid}/ids
  • 설명: 위 API 에 요청해야하는 Match Id를 가져오는 api
  • 요청변수: puuid
  • 응답변수: Match id
  • [ "KR_10자리 숫자"]
  • 링크

•  leauge-V4
  • 경로: /lol/league/v4/entries/{queue}/{tier}/{division}
  • 설명: 위 Match ID를 가져오기 위해서 puuid를 가져오는 api
  • 요청변수: 지역/티어/구간
  • 응답변수(ppuid) 
  • 링크