Nexon MapleStory OpenAPI Java Client v1.1.2

🎉 Nexon MapleStory OpenAPI Java Client v1.1.2

✨ 변경 사항

ClassName enum

• 단일 클래스 명 조회 가능하도록 수정
• api의 조회 형식인 '전사-히어로' 를 단일 String으로 사용할 때 단일 직업 명을 조회하는 메서드 추가

기존

HERO("전사-히어로")

변경

HERO("전사-히어로", "히어로")

추가

/**
     * api의 조회 형식인 '라라-전체 전직' 를 단일 String으로 사용할 때 단일 직업 명을 조회합니다.
     *
     * @param className 조회할 직업 명(enum의 className 값)
     * @return classValue 값
     */
    public static String getClassValueByClassName(String className) {
        for (ClassName c : ClassName.values()) {
            if (c.getClassName().equals(className)) {
                return c.getClassValue();
            }
        }
        throw new IllegalArgumentException("해당하는 클래스를 찾을 수 없습니다: " + className);
    }

DateValidator.java

• 날짜가 null 이거나 오늘일 경우 8시 30분 이전 조회 시 하루 전의 랭킹 정보를 조회하도록 변경

수정된 로직

        if (date == null || date.equals(today)) {
            LocalTime currentTime = LocalTime.now(KST);
            LocalTime cutoffTime = LocalTime.of(8, 30);

            if(currentTime.isBefore(cutoffTime)) {
                return today.minusDays(1);
            }
            else {
                return today;
            }
        }

🚀 시작하기

Maven

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

Gradle

implementation 'com.kmstimes:nexon-kms-openapi:1.1.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 기반으로 구현되었습니다. 모든 피드백과 기여를 환영합니다!