Maplestory-openapi

업데이트 내용
2025년 3월 20일 Nexon Open API 업데이트에 반영된 메이플스토리 스타포스 이벤트 항목, 헥사 스탯 III 관련 필드 추가 및 버그 수정

변경 사항
캐릭터 정보 조회
- 장착 장비 정보 조회 (캐시 장비 제외)
- `CharacterItemEquipmentTitleDTO`의 `titleName`, `titleIcon`, `titleDescription`에 nullable 적용
- HEXA 코어 정보 조회
- `CharacterHexaMatrixStatDTO`에 `characterHexaStatCore3`, `presetHexaStatCore3` 추가
스타포스 정보 조회
- `StarforceEventDTO `에 `destroyDecreaseRate` 추가
공통
- `dateExpire` 필드가 존재하는 모든 DTO 클래스에 `isExpired` 추가
버그 수정
API 호출 버그 수정
- API 응답에 만료된 유효 기간 데이터가 포함된 경우 역직렬화 하지 못하거나 `Invalid Date`로 변환하는 버그 수정
- [python] 칭호를 장착하지 않은 상태에서 칭호 외형만 설정한 캐릭터의 정보를 호출하는 경우 역직렬화 하지 못하는 버그 수정
오타 수정
- [python] `StarforceHistoryEvent` 의 이름이 `StarforcHistoryeEvent`로 되어있던 오타 수정

업데이트 내용
2025년 2월 20일 Nexon Open API 업데이트에 반영된 메이플스토리 유니온 챔피언 API 구현, 장착 아이템 관련 필드 추가

신규 기능
유니온 정보 조회
- 유니온 챔피언 정보 조회

변경 사항
캐릭터 정보 조회
- 장착 장비 정보 조회 (캐시 장비 제외)
- 외형 설정한 훈장, 칭호 정보가 포함되었습니다.
- 장착 캐시 장비 정보 조회
- 캐시 장비에 적용한 스킬명이 포함되었습니다. (예시: 귀멸의칼날 콜라보 스킬 `히노카미 카구라 원무일섬`)
DTO 클래스 관련
- `CharacterItemEquipmentDTO`에 `medalShape` 추가
- `CharacterItemEquipmentTitleDTO`에 `titleShapeName`, `titleShapeIcon`, `titleShapeDescription` 추가
- `CharacterCashItemEquipmentPresetDTO`에 `skills` 추가

업데이트 내용
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 구현

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