넥슨 메이플스토리 OpenAPI를 위한 Java 클라이언트 라이브러리입니다. 이 라이브러리를 사용하면 메이플스토리의 캐릭터, 길드, 랭킹 등 다양한 게임 데이터에 쉽게 접근할 수 있습니다.
- 메이플스토리 OpenAPI의 모든 엔드포인트 지원
- 사용하기 쉬운 인터페이스
- 자동 예외 처리
- 타입 안전성 보장
- 유연한 설정 옵션
<dependency>
<groupId>com.kmstimes</groupId>
<artifactId>nexon-kms-openapi</artifactId>
<version>1.3.0</version>
</dependency>implementation 'com.kmstimes:nexon-kms-openapi:1.3.0'이 라이브러리를 사용하기 위해서는 넥슨 개발자 센터에서 API 키를 발급받아야 합니다.
- 넥슨 개발자 센터에 방문하여 계정을 생성합니다.
- 새 애플리케이션을 등록하고 메이플스토리 OpenAPI 접근 권한을 요청합니다.
- 발급받은 API 키를 안전하게 보관하세요.
// API 클라이언트 초기화
MapleStoryApi mapleStoryApi = MapleStoryApi.create("your-api-key");
// 별도의 플랫폼 api를 사용할 경우
PlatfomApi platfomApi = PlatformApi.create("your-api-key");
// 캐릭터 OCID 조회
String ocid = api.Character().getId("캐릭터명").ocid();
// 캐릭터 기본 정보 조회
LocalDate date = LocalDate.now();
BasicResponse basicInfo = api.Character().getCharacterBasic(ocid, date);
System.out.println("캐릭터 이름: " + basicInfo.character_name());
System.out.println("레벨: " + basicInfo.character_level());
System.out.println("직업: " + basicInfo.character_class());// 빌더를 사용한 커스텀 설정
MapleStoryApi mapleStoryApi = MapleStoryApi.builder()
.apiKey("your-api-key")
.connectTimeout(15) // 연결 타임아웃 15초
.readTimeout(30) // 읽기 타임아웃 30초
.build();
PlatformApi platformApi = PlatformApi.builder()
.apiKey("your-api-key")
.connectTimeout(15) // 연결 타임아웃 15초
.readTimeout(30) // 읽기 타임아웃 30초
.build();
// 길드 정보 조회
GuildBasicResponse guildInfo = api.Guild().getGuildBasic("길드명", "월드명", LocalDate.now());이 프로젝트는 MIT 라이선스 하에 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.
- 개발자: Jinhyeok Ko
- 조직: The Maple Times
- GitHub: https://github.com/TheMapleTimes