Maplestory-openapi

업데이트 내용
2025년 1월 16일 Nexon Open API 업데이트에 반영된 메이플스토리 캐릭터 외형 이미지 API의 파라미터 확장

변경 사항
캐릭터 외형 이미지 조회
- `CharacterImageOption`에 `actionFrame`, `emotionFrame` 추가
- 캐릭터의 액션과 감정표현의 frame을 지정할 수 있습니다.
- frame 값 허용 범위는 https://openapi.nexon.com/ko/support/notice/2715682/ 에 게시되어 있습니다.

업데이트 내용
2024년 12월 19일 Nexon Open API 업데이트에 반영된 메이플스토리 캐릭터 외형 이미지 API의 파라미터 확장

신규 기능
캐릭터 정보 조회
- 캐릭터 외형 이미지 조회의 자세(action) 파라미터 확장
- `CharacterImageAction.Ladder`
- `CharacterImageAction.Rope`
- `CharacterImageAction.Heal`
- `CharacterImageAction.Alert`
- `CharacterImageAction.ProneStab`
- `CharacterImageAction.SwingO1`
- `CharacterImageAction.SwingO2`
- `CharacterImageAction.SwingO3`
- `CharacterImageAction.SwingOF`
- `CharacterImageAction.SwingP1`
- `CharacterImageAction.SwingP2`
- `CharacterImageAction.SwingPF`
- `CharacterImageAction.SwingT1`
- `CharacterImageAction.SwingT2`
- `CharacterImageAction.SwingT3`
- `CharacterImageAction.SwingTF`
- `CharacterImageAction.StabO1`
- `CharacterImageAction.StabO2`
- `CharacterImageAction.StabOF`
- `CharacterImageAction.StabT1`
- `CharacterImageAction.StabT2`
- `CharacterImageAction.StabTF`
- `CharacterImageAction.Shoot1`
- `CharacterImageAction.Shoot2`
- `CharacterImageAction.ShootF`
- `CharacterImageAction.Dead`
- `CharacterImageAction.GhostWalk`
- `CharacterImageAction.GhostStand`
- `CharacterImageAction.GhostJump`
- `CharacterImageAction.GhostProneStab`
- `CharacterImageAction.GhostLadder`
- `CharacterImageAction.GhostRope`
- `CharacterImageAction.GhostFly`
- `CharacterImageAction.GhostSit`
- 캐릭터 외형 이미지 조회의 표정(emotion) 파라미터 확장
- `CharacterImageEmotion.Blink`
- `CharacterImageEmotion.Blaze`
- `CharacterImageEmotion.Bowing`
- `CharacterImageEmotion.Cheers`
- `CharacterImageEmotion.Chu`
- `CharacterImageEmotion.Dam`
- `CharacterImageEmotion.Despair`
- `CharacterImageEmotion.Glitter`
- `CharacterImageEmotion.Hit`
- `CharacterImageEmotion.Hot`
- `CharacterImageEmotion.Hum`
- `CharacterImageEmotion.Love`
- `CharacterImageEmotion.Oops`
- `CharacterImageEmotion.Pain`
- `CharacterImageEmotion.Troubled`
- `CharacterImageEmotion.QBlue`
- `CharacterImageEmotion.Shine`
- `CharacterImageEmotion.Stunned`
- `CharacterImageEmotion.Vomit`
- 캐릭터 외형 이미지 조회의 무기 모션(wmotion) 파라미터 확장
- `CharacterImageWeaponMotion.Nothing`

업데이트 내용
2024년 11월 21일 Nexon Open API 업데이트에 반영된 메이플스토리 캐릭터 외형 이미지 API 구현

신규 기능
캐릭터 정보 조회
- 캐릭터 외형 이미지 조회
- [js, java] `getCharacterImage()`
- [C] `GetCharacterImage()`
- [python] `get_character_image()`
- 캐릭터의 외형은 `action`, `emotion`, `wmotion`을 통해 설정할 수 있습니다. 항목별 `enum` 클래스가 제공됩니다.
- 이미지 렌더링 정보는 `width`, `height`, `x`, `y`를 통해 설정할 수 있습니다.
- 기본 `x`, `y`는 96이며 최대 1000까지 설정 가능합니다.
- 기본 `y`는 86이며 권장값은 `height - 10`입니다.

버그 수정
오타 수정
- [C] `GetCharacterBasic()`의 파라미터 주석 오류 수정

업데이트 내용
2024년 7월 18일 Nexon Open API 업데이트에 반영된 메이플스토리 공지 API 구현

신규 기능
공지 정보 조회
- 공지사항 목록 조회
- 공지사항 상세 조회
- 업데이트 목록 조회
- 업데이트 상세 조회
- 진행 중 이벤트 목록 조회
- 진행 중 이벤트 상세 조회
- 캐시샵 공지 목록 조회
- 캐시샵 공지 상세 조회

업데이트 내용
버그 수정, API 설명 수정

변경 사항
실시간 API 적용
- `길드 정보 조회` API가 실시간 조회 기능을 제공합니다.
- API를 호출할 때 날짜를 특정하지 않으면 실시간 데이터를 조회할 수 있습니다.
주석 업데이트
- 캐릭터 정보 조회, 유니온 정보 조회, 길드 정보 조회 API의 전일 데이터 조회 가능 시간 설명 변경(https://openapi.nexon.com/ko/support/notice/2597202/ 패치 우선 적용)

버그 수정
API 호출 버그 수정
- [JS] `getStarforceHistory()`에서 API의 데이터를 역직렬화 하지 못하는 버그 수정
- [Python] `get_cube_history()`, `get_potential_history()`, `get_starforce_history()`에서 API의 데이터를 역직렬화 하지 못하는 버그 수정
- [Python] `get_cube_history()`, `get_potential_history()`, `get_starforce_history()`에서 기본 날짜를 할당하지 않는 버그 수정
- [공통] `CharacterVMatrixCoreEquipment`에서 `v_core_name`, `v_core_type`가 nullable이 허용되지 않던 버그 수정
오타 수정
- [Java] `CharacterVMatrixCoreEquipmentDTO`의 이름이 `CharacterVMatrixCodeEquipmentDTO`로 되어있던 오타 수정

업데이트 내용
2024년 5월 22일, 6월7일 Nexon Open API 업데이트에 반영된 메이플스토리 캐릭터 목록 API 구현, 일부 추가 데이터 반영, 버그 수정

신규 기능
캐릭터 정보 조회
- 캐릭터 목록 조회

변경 사항
DTO 클래스 관련
- `CharacterSkillInfoDTO`에 `skillEffectNext`가 추가되었습니다.
- `CharacterLinkSkillInfoDTO`에 `skillEffectNext`가 추가되었습니다.
- `CharacterSetEffectSetDTO`에 `setOptionFull`가 추가되었습니다.
- `CharacterBasicDTO`에 `characterDateCreate`, `accessFlag`, `liberationQuestClearFlag`가 추가되었습니다.
ErrorCode 관련
- `OPENAPI00011`에 대한 내용이 추가되었습니다.
테스트
- API 테스트 스크립트를 언어별로 추가하였습니다.
문서화
- 샘플 코드의 내용을 `큐브 사용 기록 조회`에서 `캐릭터 기본 정보 조회`로 변경하였습니다.
- 샘플 코드의 참조로써 여러 테스트 케이스로 이동할 수 있도록 링크를 추가하였습니다.
- 리포지토리의 테스트 성공/실패 상태를 표기하도록 하였습니다.

버그 수정
API 호출 버그 수정
- [JS] `getStarforceHistory()`에서 기본 날짜를 할당하지 않는 버그 수정
- [Java] `getCharacterBeautyEquipment()`에서 날짜 파라미터에 nullable이 허용되지 않던 버그 수정
- [C] `GetOverallRanking()`에서 query 문제로 API가 동작하지 않던 버그 수정
- [Python] `get_character_basic()`에서 기본 날짜를 할당하지 않는 버그 수정
- [Python] `get_union_artifact()`에서 API의 데이터를 `UnionArtifactCrystal`로 역직렬화하지 못하는 버그 수정
- [Python] `CharacterAndroidEquipmentPreset`에서 `android_hair`, `android_face`를 역직렬화하지 못하는 버그 수정
- [Python] `CharacterAndroidEquipmentPreset`에서 `android_skin_name`가 nullable이 허용되지 않던 버그 수정
- [Python] `CharacterDojang`에서 `date_dojang_record`가 nullable이 허용되지 않던 버그 수정
오타 수정
- [Java] 동기 메소드 `getCharacterSetEffect()`의 이름이 `getCharacterSetEffectAsync()`로 되어있던 오타 수정
- [C] `GetCharacterSetEffect()` 이름이 `GetCharacterSetEffectAsync()`로 되어있던 오타 수정
- [C] `UnionArtifactDTO`의 네임스페이스를 `MapleStory.OpenAPI.Src.Dto.Union` → `MapleStory.OpenAPI.Dto`로 변경
- [Python] `UnionRaider`의 `use_preset_no` 가 `use_preset_not`로 되어있던 오타 수정

지원 종료
길드 정보 조회
- `GuildBasicDTO` 타입의 `guildMark`, `guildMarkCustom`을 더 이상 제공하지 않습니다. (https://openapi.nexon.com/support/notice/2580309/ 패치 우선 적용)