RIOT API 사용법 및 연동하기

이번 포스팅에서는 riot api 를 사용하는 방법과 챔피언 숙련도 검색페이지를 제작해보겠습니다.

RIOT API?

RIOT API는 Riot Games가 제공하는 API로, League of Legends(롤) 와 관련된 데이터에 접근할 수 있게 해주는 프로그래밍 인터페이스입니다.

RIOT API를 사용하면 개발자들은 LoL 게임 데이터를 활용하여 사용자 정의 애플리케이션, 웹사이트, 통계 분석 도구 등을 개발할 수 있습니다. 예를 들어, 실시간으로 게임 정보를 추적하거나 유저의 전적을 조회하는 기능을 개발할 수 있습니다.

RIOT API는 RESTful API로서, HTTP 요청을 통해 데이터에 접근합니다. 다양한 엔드포인트를 통해 게임 데이터, 리그 정보, 매치 데이터, 챔피언 정보, 아이템 정보 등 다양한 정보를 얻을 수 있습니다. API 키를 발급받아야 하며, 이 키는 API 요청을 인증하는 데 사용됩니다.

RIOT API 기능 모음집🌻

LEAGUE OF LEGENDS

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 매치의 상세 정보, 플레이어 정보, 팀 정보, 순위 등을 제공합니다.

RIOT API 사용해보기

API KEY 발급 및 적용

라이엇 게임즈 개발자 포털
https://developer.riotgames.com/

위 URL로 가서 로그인을 해줍니다 계정은 RIOT GAMES계정입니다.
롤계정으로 로그인 가능합니다.

들어가셔서 로그인 진행해주시고 로그인이 완료되었다면 메인페이지로 돌아오세요.

그리고 APIS 로 이동합니다.

APIS로 들어오면 이와같은 화면이 나올텐데요 위 화면이 API들의 사용법과 사용예시를 보여줍니다.

그럼 가장유명한 페이커선수의 계정을 한번 검색해보겠습니다.

계정 검색해보기

위 사진을 보시면, 좌측 탭에서 SUMMONER로 이동합니다. 그러면 우측에 6개의 탭이 보일텐데요 각 탭마다 다른기능을 가지고있습니다.
저희는 그중 3번째의 탭을 사용할 것입니다. 맨앞에 GET이라고 적혀있는데, 이것은 GET방식으로 요청되는 API라고 설명한다고 생각하시면 됩니다.
누르시면 많이 나오는데 사용법으로 바로가보겠습니다.

위 화면을 설명해드리자면 summonerName이 소환사 이름을 검색하는 곳입니다.
두번째는 서버를 선택하는 곳입니다.
그리고 3번째는 API키를 입력하는 탭이고 기본적으로 받은 API키가 있기때문에 그냥두시면 됩니다.
INCLUDE APIKEY는 QUERY로 보낼지 HEADER로 보낼지 포함하지 않을지에따라서 요청하는 URL이 달라집니다 저는 QUERY로 하겠습니다.

EXECUTE REQUEST로 요청해보겠습니다.

요청에 성공했기때문에 RESPONSE CODE가 200으로 잡힙니다.
그리고 REQUEST URL에는 제가 후에 요청할 URL입니다. 실제 서비스 개발할때에 GET방식으로 저 URL을 삽입할것입니다.
모자이크 된 곳은 저희가 발급 받은 API-KEY입니다.

밑으로 더 내려가서 보겠습니다.

이 RESPONSE BODY가 실제로 요청한 값입니다.
주절주절 많이 써져있는 부분은 암호화된 아이디입니다.
이 정보를 나중에 다른 API를 사용할때 쓸 수 있습니다.

이번 포스팅은 여기서 마치고, 다음 포스팅에서 본격적으로 REACT를 활용하여 웹 서비스를 만들어가는 과정을 포스팅 하겠습니다.

유익하셨다면 좋아요 눌러주세요 !