파이썬으로 메이플 Open API 사용하는 방법

넥슨에서는 인기게임의 다양한 데이터를 활용할 수 있도록, Open API를 제공하고 있다.

 

Open API는 Java, Java Script, Python 등 다양한 언어로 사용할 수 있다.

 

이번 포스팅에서는 가장 간단하고 인기 있는 파이썬으로 메이플스토리 Open API를 사용하는 방법에 대해 다루고자 한다.

 

Open API는 API key를 발급받아야 사용할 수 있으므로,  [도구 설치 설명서/기타] - 넥슨게임 API키 발급받는 방법을 참고하여 키를 발급받고 진행해야 한다.

 

넥슨게임 API키 발급받는 방법

 

 

샘플코드 받기

 

넥슨 Open API 공식 홈페이지

 

넥슨사에서는 API를 사용하기 위한 샘플코드를 공개하고 있다.

 

물론 샘플코드 없이도 충분히 개발은 가능하지만, 샘플코드를 활용한다면 쉽게 사용법을 익힐 수 있고 시간을 절약할 수 있기 때문에 적극 활용하는 것을 권장한다.

 

넥슨 Open API 제공 사이트에 접속하게 되면, 'API 사용하기'라는 글의 제목과 함께 API 사용법에 대해 자세히 기술되어 있는 문서가 나타난다.

 

NEXON Open API

 

파이썬 샘플코드 복사

 

스크롤을 아래로 내리다 보면, Python 샘플코드가 보일 것이다.

 

우측 상단의 복사아이콘을 클릭하여 샘플코드 전체를 복사한다.

 

샘플코드 사용

 

샘플코드 수정

 

파이썬 소스파일(py)을 생성한 뒤, 복사한 샘플코드를 붙여 넣는다.

 

그리고, 샘플코드에서 수정해야 할 부분은 4가지이다. 아래 테이블을 참고하여 알맞게 수정한다.

 

번호	수정내용
1	' import requests ' 코드 추가
2	발급받은 Open API Key 기입
3	ocid 값을 가져올 메이플스토리 내 유저의 캐릭터명
4	' heroes ' → ' maplestory ' 수정

 

ocid는 '캐릭터 고유 식별자'로, 쉽게 말하자면 각 유저마다 부여되는 중복되지 않는 ID라고 생각하면 된다.

 

기본적으로 ocid가 있어야 캐릭터의 랭킹이나 인기도, 레벨 등 다양한 정보를 얻어올 수 있다.

 

즉, 임의의 유저에 대한 어떤 정보를 가져오고 싶다면, ocid값을 가져오는 과정은 반드시 필요하다.

 

 

샘플코드 수정 후

 

샘플코드를 수정한 뒤의 코드이다.

 

필자는 메이플스토리 월드랭킹 2등의 '단솜' 유저를 대상으로 했다.

 

수정사항을 모두 기입했다면 샘플코드를 컴파일한다.

 

컴파일 결과

 

컴파일 결과

 

샘플코드를 실행하면 '단솜' 유저의 ocid의 값이 담긴 딕셔너리 데이터가 반환된다.

 

이렇게 반환된 ocid는 캐릭터의 정보를 가져오는데, 반드시 필요한 파라미터의 역할을 하게 된다.

 

 

---

 

궁금한 사항이나 질문, 피드백 등 의견을 댓글로 남겨주시면 답변드리겠습니다.

감사합니다.