Riot API 사용하기 (웹사이트)

SUMMONER-V4

 

SUMMONER-V4 API는 사용자에 관련된 정보들을 받을 수 있는 API 입니다.

해당 API에서는 다음과 같이 5가지의 세부 API가 존재합니다. 동일한 API이지만, 어떤 변수를 받을지에 따라서 나뉘어지고 있습니다.

 

첫번째 encrypted AccountId(암호화된 account id)

두번째는 소환사 계정명

세번째는 encrypted PUUID(암호화된 puuid)

네번째는 encrypted SummonerId (암호화된 Summoner ID)

다섯번째는 나의 계정(API 인증을 받은 계정)

 

Account ID와 PUUID, Summoner ID는 Riot이 임의적으로 만든 ID이기 때문에 우리는 이러한 값들은 알지 못합니다.

이 값들을 알기 위해서 우리는 소환사 계정명(2번째 API)을 통해서 알 수 있습니다.

 

https://developer.riotgames.com/apis#summoner-v4/GET_getBySummonerName

해당 페이지에서 Summoner Name 에 우리가 잘 알고 있는 페이커 선수 아이디를 넣고 API 요청 버튼을 눌러보겠습니다.

다음과 같은 결과값을 얻을 수 있습니다.

 

첫번째 Request URL 은 우리가 API를 호출한 URL 입니다.

두번째 Request Header은 URL을 호출할 때, 우리가 필요한 정보(유저 환경과 Riot에서 발급받은 키)를 담아서 보내는 것입니다. (코드 작업시 필요한 내용이니 복사 해서 보관하세요!)

세번째 Respnse Code는 호출 결과를 나타냅니다. 결과값으로 200을 받았다는 의미는 API 호출이 정상적으로 되었다는 것을 나타냅니다.

 

400(Bad request), 401(Unauthorized), 403(Forbidden), 404(Data not found), 405(Method not allowed), 415(Unsupported media type), 429(Rate limit exceeded), 500(Internal server error), 502(Bad gateway), 503(Service unavailable), 504(Gateway timeout)

 

네번째, Response Header은 응답에 관한 정보를 나타내주는데 분석에 불필요한 내용이니 무시하셔도 됩니다.

다섯번째, Response Body가 우리가 알고 싶어하는 결과값을 나타내주는 항목입니다.

 

우리는 페이커선수의 소환사 계정명(hide on bush)을 통해서, 페이커 선수의 id(summoner id), account id와 puuid를 알게 되었습니다. 

그럼 페이커 선수의 account id (YKuqwYyemn5bwLLGLrX7rcvJB06tN-KAagNy5DCG0PKS)로 첫번째 API를 사용해보겠습니다.

 

(encrypted AccountId 는 암호화된 Account ID로써 이미 우리가 위 작업에서 받은 Account ID가 암호화된 ID이기 때문에 그냥 넣으시면 됩니다.)

다음과 같이 변수명에 Account ID를 넣어보시고 Execute Request 버튼을 누르면,

계정명을 넣었던 것과 같은 결과를 받게 됩니다. summoner id, puuid도 동일하니 생략하도록 하겠습니다.

 

다음 포스팅에서부터는 파이썬을 통해서 코드로 작업을 진행해보도록 하겠습니다.