🎉 Nexon MapleStory OpenAPI Java Client v1.2.2

✨ 추가 사항

업데이트 적용

• https://openapi.nexon.com/ko/support/notice/3312738/
• 캐릭터 정보 조회의 장착 심볼 정보 조회에서 심볼에 부여된 추가 효과를 조회할 수 있는 기능이 추가
• 캐릭터 정보 조회의 장착 캐시 장비 정보 조회에서 캐시 무기 아이템의 무기 이펙트 프리즘 정보를 조회할 수 있는 기능이 추가
  • 접속한 캐릭터의 무기 이펙트 프리즘 정보가 제공
• 캐릭터 정보 조회의 장착 캐시 장비 정보 조회에서 캐시 얼굴장식 아이템에 합성된 표정 정보를 조회할 수 있는 기능이 추가
• 공지 정보 조회의 진행 중 이벤트 목록 조회, 캐시샵 공지 목록 조회에서 공지의 썸네일 이미지를 조회할 수 있는 기능이 추가

🚀 시작하기

Maven

<dependency>
    <groupId>com.kmstimes</groupId>
    <artifactId>nexon-kms-openapi</artifactId>
    <version>1.2.2</version>
</dependency>

Gradle

implementation 'com.kmstimes:nexon-kms-openapi:1.2.2'

📋 사용 예제

// API 클라이언트 초기화
MapleStoryApi api = MapleStoryApi.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());

📌 주의사항

• Open API를 이용하여 이용약관에 명시되어 있는 사항 내에서 자유롭게 애플리케이션을 제작하실 수 있습니다만, 제작 시 데이터를 NEXON Open API에서 제공 받았음을 애플리케이션 내에 명시해주셔야 합니다.
• 서비스 및 애플리케이션에 'Data based on NEXON Open API'라는 문구를 명시해주시길 바랍니다.

🔗 유용한 링크

• GitHub 저장소
• 넥슨 개발자 센터
• API 문서

📄 라이선스

이 프로젝트는 MIT 라이선스 하에 배포됩니다.

이 릴리즈는 Java 17 이상을 지원하며, Retrofit2 기반으로 구현되었습니다. 모든 피드백과 기여를 환영합니다!