메이플스토리 OpenAPI, 파이썬 라이브러리 사용방법

넥슨에서 제공하는 게임 Open API는 다양한 언어에서 사용할 수 있다.

 

[기술 리뷰/소프트웨어]  파이썬으로 메이플 유저 기본정보 조회하는 방법의 내용처럼 도큐먼트의 예제코드를 변형해 프로그램을 구현할 수 있다.

 

하지만, 사용하기 편리하도록 라이브러리 형태로 정리해 놓은 유틸을 사용하면 개발시간을 줄일 수 있다.

 

파이썬으로 메이플 유저 기본정보 조회하는 방법

 

 

 

 

깃허브 접속

메이플 라이브러리 깃허브

 

깃허브(https://github.com/SpiralMoon/maplestory.openapi)에는 메이플 API를 사용하기 위한 라이브러리가 등록되어 있다.

 

이번 포스팅에서는 압축파일로 설치하지 않고 깃으로 설치할 것이다.

 

깃이 설치되어있지 않다면, 우선 깃을 설치하도록 한다.

 

[도구 설치 설명서/코딩 도구]  윈도우10 환경에서 Git 설치하는 방법

윈도우10 환경에서 Git 설치하는 방법

 

 

 

 

다운로드

깃 배쉬열기

 

깃 배쉬를 실행하기 위해서 다운로드 폴더 내 우클릭 후, ' Open Git Bash here '를 클릭한다.

 

깃 배쉬 명령어 입력

 

깃 저장소로부터 다운로드하는 명령어를 작성하여, 메이플 라이브러리를 다운로드한다.

 

commend : git clone https://github.com/SpiralMoon/maplestory.openapi

 

깃허브의 주소는 위에서 첨부한 링크를 붙여 넣기 하면 된다.

 

깃 배쉬에서는 Ctrl + v 명령어가 동작하지 않으므로, 우클릭 후 'Paste'를 클릭하여 주소를 붙여 넣어야 한다.

 

 

또는, Shift + Insert 단축키를 이용하여 주소를 붙여 넣는다.

 

명령어를 입력하고 엔터키를 누르면 메이플 API가 다운로드된다.

 

 

 

 

가상환경 설정

 

메이플스토리 API 라이브러리에 대한 가상환경 설정방법에 대해서는 본 포스팅에서 따로 다루지 않는다.

 

가상환경의 권장옵션은 Python 버전 3.9 이상이며, 가상환경에서 설치하는 명령어는 아래 하나이다.

pip install maplestory-openapi

 

 

오픈보이스에서 가상환경을 세팅을 했던 과정과 동일하니, 관련 포스팅을 참고하여 가상환경을 세팅해야 한다.

 

 

[기술 리뷰/인공지능] 음성복제 AI, 오픈보이스(OpenVoice) 설치방법

 

음성복제 AI, 오픈보이스(OpenVoice) 설치방법

 

 

 

 

코드 수정

 

파이참 프로젝트 열기

 

다운로드한 폴더 내에서 우클릭한 후, 파이참으로 열기 버튼을 클릭한다.

 

 

테스트 코드

 

좌측에서 Python 폴더 내의 test.py 코드파일을 찾아 더블클릭한다.

 

원래의 코드

 

위와 같이 코드가 기재되어 있을 것이다.

 

빨간색 사각형으로 표시한 부분을 수정해야 한다.

 

수정코드

 

첫 번째 네모박스에서는 os.environ.get() 메서드를 삭제한 뒤 발급받은 API 키를 기입하고, 두 번째 네모박스에서 조회하고자 하는 캐릭터 명으로 수정한다.

 

 

 

 

 

컴파일 결과

 

컴파일 결과

 

수정된 코드를 컴파일을 하게 되면, 콘솔창에  조회하는 캐릭터의 기본정보가 출력된다.

 

 

 

 

다양한 라이브러리

 

타 메서드

 

기본정보 조회뿐만 아니라, Open API에 기재된 공식 기능은 모두 구현해 놓은 라이브러리이다.

 

넥슨의 도큐먼트에서 필요하고자 하는 메서드의 이름을 찾아서 작성만 하면 기능을 사용할 수 있다.

 

또 , 다른 언어도 지원하니 메이플 관련 플랫폼이나 애플리케이션을 개발한다면 충분히 참고할만한 라이브러리이다.

 

 

---

 

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

감사합니다.