maplestory-openapi 2.4.1 → 2.7.2

package/types/maplestory/api/mapleStoryApi.d.ts

@@ -10,6 +10,7 @@ import { CharacterHexaMatrixStatDto } from './dto/character/characterHexaMatrixS
 import { CharacterHyperStatDto } from './dto/character/characterHyperStatDto';
 import { CharacterItemEquipmentDto } from './dto/character/characterItemEquipmentDto';
 import { CharacterLinkSkillDto } from './dto/character/characterLinkSkillDto';
+import { CharacterListDto } from './dto/character/characterListDto';
 import { CharacterPetEquipmentDto } from './dto/character/characterPetEquipmentDto';
 import { CharacterPopularityDto } from './dto/character/characterPopularityDto';
 import { CharacterPropensityDto } from './dto/character/characterPropensityDto';
@@ -24,6 +25,14 @@ import { CubeHistoryResponseDto } from './dto/history/cubeHistoryResponseDto';
 import { PotentialHistoryResponseDto } from './dto/history/potentialHistoryResponseDto';
 import { StarforceHistoryResponseDto } from './dto/history/starforceHistoryResponseDto';
 import { InspectionInfoDto } from './dto/inspectionInfoDto';
+import { CashshopNoticeDetailDto } from './dto/notice/cashshopNoticeDetailDto';
+import { CashshopNoticeListDto } from './dto/notice/cashshopNoticeListDto';
+import { EventNoticeDetailDto } from './dto/notice/eventNoticeDetailDto';
+import { EventNoticeListDto } from './dto/notice/eventNoticeListDto';
+import { NoticeDetailDto } from './dto/notice/noticeDetailDto';
+import { NoticeListDto } from './dto/notice/noticeListDto';
+import { UpdateNoticeDetailDto } from './dto/notice/updateNoticeDetailDto';
+import { UpdateNoticeListDto } from './dto/notice/updateNoticeListDto';
 import { AchievementRankingResponseDto } from './dto/ranking/achievementRankingResponseDto';
 import { DojangRankingResponseDto } from './dto/ranking/dojangRankingResponseDto';
 import { GuildRankingResponseDto } from './dto/ranking/guildRankingResponseDto';
@@ -48,17 +57,26 @@ declare class MapleStoryApi {
     constructor(apiKey: string);
     /**
      * 캐릭터 식별자(ocid)를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param characterName    캐릭터 명
      */
     getCharacter(characterName: string): Promise<CharacterDto>;
+    /**
+     * 계정의 보유 캐릭터 목록을 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
+     * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     */
+    getCharacterList(): Promise<CharacterListDto>;
     /**
      * 기본 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
@@ -67,8 +85,9 @@ declare class MapleStoryApi {
     getCharacterBasic(ocid: string, dateOptions?: DateOptions): Promise<CharacterBasicDto>;
     /**
      * 인기도 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
@@ -77,8 +96,9 @@ declare class MapleStoryApi {
     getCharacterPopularity(ocid: string, dateOptions?: DateOptions): Promise<CharacterPopularityDto>;
     /**
      * 종합 능력치 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
@@ -87,8 +107,9 @@ declare class MapleStoryApi {
     getCharacterStat(ocid: string, dateOptions?: DateOptions): Promise<CharacterStatDto>;
     /**
      * 하이퍼스탯 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
@@ -97,8 +118,9 @@ declare class MapleStoryApi {
     getCharacterHyperStat(ocid: string, dateOptions?: DateOptions): Promise<CharacterHyperStatDto>;
     /**
      * 성향 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
@@ -107,8 +129,9 @@ declare class MapleStoryApi {
     getCharacterPropensity(ocid: string, dateOptions?: DateOptions): Promise<CharacterPropensityDto>;
     /**
      * 어빌리티 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
@@ -117,8 +140,9 @@ declare class MapleStoryApi {
     getCharacterAbility(ocid: string, dateOptions?: DateOptions): Promise<CharacterAbilityDto>;
     /**
      * 장착한 장비 중 캐시 장비를 제외한 나머지 장비 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
@@ -127,8 +151,9 @@ declare class MapleStoryApi {
     getCharacterItemEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterItemEquipmentDto>;
     /**
      * 장착한 캐시 장비 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
@@ -137,8 +162,9 @@ declare class MapleStoryApi {
     getCharacterCashItemEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterCashItemEquipmentDto>;
     /**
      * 장착한 심볼 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
@@ -147,8 +173,9 @@ declare class MapleStoryApi {
     getCharacterSymbolEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterSymbolEquipmentDto>;
     /**
      * 적용받고 있는 세트 효과 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
@@ -157,8 +184,9 @@ declare class MapleStoryApi {
     getCharacterSetEffect(ocid: string, dateOptions?: DateOptions): Promise<CharacterSetEffectDto>;
     /**
      * 장착 중인 헤어, 성형, 피부 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
@@ -167,8 +195,9 @@ declare class MapleStoryApi {
     getCharacterBeautyEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterBeautyEquipmentDto>;
     /**
      * 장착한 안드로이드 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
@@ -177,8 +206,9 @@ declare class MapleStoryApi {
     getCharacterAndroidEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterAndroidEquipmentDto>;
     /**
      * 장착한 펫 및 펫 스킬, 장비 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
@@ -187,8 +217,9 @@ declare class MapleStoryApi {
     getCharacterPetEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterPetEquipmentDto>;
     /**
      * 캐릭터 스킬과 하이퍼 스킬 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
@@ -209,8 +240,9 @@ declare class MapleStoryApi {
     getCharacterSkill(ocid: string, characterSkillGrade: string, dateOptions?: DateOptions): Promise<CharacterSkillDto>;
     /**
      * 장착 링크 스킬 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
@@ -219,8 +251,9 @@ declare class MapleStoryApi {
     getCharacterLinkSkill(ocid: string, dateOptions?: DateOptions): Promise<CharacterLinkSkillDto>;
     /**
      * V매트릭스 슬롯 정보와 장착한 V코어 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
@@ -229,8 +262,9 @@ declare class MapleStoryApi {
     getCharacterVMatrix(ocid: string, dateOptions?: DateOptions): Promise<CharacterVMatrixDto>;
     /**
      * HEXA 매트릭스에 장착한 HEXA 코어 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
@@ -239,8 +273,9 @@ declare class MapleStoryApi {
     getCharacterHexaMatrix(ocid: string, dateOptions?: DateOptions): Promise<CharacterHexaMatrixDto>;
     /**
      * HEXA 매트릭스에 설정한 HEXA 스탯 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
@@ -249,8 +284,9 @@ declare class MapleStoryApi {
     getCharacterHexaMatrixStat(ocid: string, dateOptions?: DateOptions): Promise<CharacterHexaMatrixStatDto>;
     /**
      * 캐릭터 무릉도장 최고 기록 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
@@ -259,8 +295,9 @@ declare class MapleStoryApi {
     getCharacterDojang(ocid: string, dateOptions?: DateOptions): Promise<CharacterDojangDto>;
     /**
      * 유니온 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 유니온 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
@@ -269,8 +306,9 @@ declare class MapleStoryApi {
     getUnion(ocid: string, dateOptions?: DateOptions): Promise<UnionDto>;
     /**
      * 유니온 공격대 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 유니온 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
@@ -279,8 +317,9 @@ declare class MapleStoryApi {
     getUnionRaider(ocid: string, dateOptions?: DateOptions): Promise<UnionRaiderDto>;
     /**
      * 유니온 아티팩트 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 유니온 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
@@ -289,8 +328,9 @@ declare class MapleStoryApi {
     getUnionArtifact(ocid: string, dateOptions?: DateOptions): Promise<UnionArtifactDto>;
     /**
      * 길드 식별자(oguild_id) 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 길드 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.).
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param guildName 길드 명
@@ -299,8 +339,9 @@ declare class MapleStoryApi {
     getGuild(guildName: string, worldName: string): Promise<GuildDto>;
     /**
      * 길드 기본 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 길드 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.).
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param guildId 길드 식별자
@@ -452,6 +493,66 @@ declare class MapleStoryApi {
      * @param dateOptions 조회 기준일 (KST)
      */
     getAchievementRanking(filterOptions?: AchievementRankingApiFilterOptions, dateOptions?: DateOptions): Promise<AchievementRankingResponseDto>;
+    /**
+     * 메이플스토리 공지사항에 최근 등록된 게시글 20개를 조회합니다.
+     *
+     * - 공지 정보 API는 데이터 최신화(공지 내용 수정/ 업데이트 고려)를 위해 실시간 조회 또는 최소 일배치 작업을 권장합니다.
+     * - 실시간으로 정보를 제공하지 않는 경우, 신규/수정 공지 내용이 반영되지 않을 수 있으니 서비스 이용 유저에게 홈페이지 공지 사항을 확인하라는 가이드를 제공해주세요.
+     */
+    getNoticeList(): Promise<NoticeListDto>;
+    /**
+     * 메이플스토리 공지사항 게시글 세부 사항을 조회합니다.
+     *
+     * - 공지 정보 API는 데이터 최신화(공지 내용 수정/ 업데이트 고려)를 위해 실시간 조회 또는 최소 일배치 작업을 권장합니다.
+     * - 실시간으로 정보를 제공하지 않는 경우, 신규/수정 공지 내용이 반영되지 않을 수 있으니 서비스 이용 유저에게 홈페이지 공지 사항을 확인하라는 가이드를 제공해주세요.
+     * @param noticeId 공지 식별자
+     */
+    getNoticeDetail(noticeId: number): Promise<NoticeDetailDto>;
+    /**
+     * 메이플스토리 업데이트에 최근 등록된 게시글 20개를 조회합니다.
+     *
+     * - 공지 정보 API는 데이터 최신화(공지 내용 수정/ 업데이트 고려)를 위해 실시간 조회 또는 최소 일배치 작업을 권장합니다.
+     * - 실시간으로 정보를 제공하지 않는 경우, 신규/수정 공지 내용이 반영되지 않을 수 있으니 서비스 이용 유저에게 홈페이지 공지 사항을 확인하라는 가이드를 제공해주세요.
+     */
+    getUpdateNoticeList(): Promise<UpdateNoticeListDto>;
+    /**
+     * 메이플스토리 업데이트 게시글 세부 사항을 조회합니다.
+     *
+     * - 공지 정보 API는 데이터 최신화(공지 내용 수정/ 업데이트 고려)를 위해 실시간 조회 또는 최소 일배치 작업을 권장합니다.
+     * - 실시간으로 정보를 제공하지 않는 경우, 신규/수정 공지 내용이 반영되지 않을 수 있으니 서비스 이용 유저에게 홈페이지 공지 사항을 확인하라는 가이드를 제공해주세요.
+     * @param noticeId 공지 식별자
+     */
+    getUpdateNoticeDetail(noticeId: number): Promise<UpdateNoticeDetailDto>;
+    /**
+     * 메이플스토리 진행 중 이벤트에 최근 등록된 공지사항 20개를 조회합니다.
+     *
+     * - 공지 정보 API는 데이터 최신화(공지 내용 수정/ 업데이트 고려)를 위해 실시간 조회 또는 최소 일배치 작업을 권장합니다.
+     * - 실시간으로 정보를 제공하지 않는 경우, 신규/수정 공지 내용이 반영되지 않을 수 있으니 서비스 이용 유저에게 홈페이지 공지 사항을 확인하라는 가이드를 제공해주세요.
+     */
+    getEventNoticeList(): Promise<EventNoticeListDto>;
+    /**
+     * 메이플스토리 진행 중 이벤트 게시글 세부 사항을 조회합니다.
+     *
+     * - 공지 정보 API는 데이터 최신화(공지 내용 수정/ 업데이트 고려)를 위해 실시간 조회 또는 최소 일배치 작업을 권장합니다.
+     * - 실시간으로 정보를 제공하지 않는 경우, 신규/수정 공지 내용이 반영되지 않을 수 있으니 서비스 이용 유저에게 홈페이지 공지 사항을 확인하라는 가이드를 제공해주세요.
+     * @param noticeId 공지 식별자
+     */
+    getEventNoticeDetail(noticeId: number): Promise<EventNoticeDetailDto>;
+    /**
+     * 메이플스토리 캐시샵 공지에 최근 등록된 공지사항 20개를 조회합니다.
+     *
+     * - 공지 정보 API는 데이터 최신화(공지 내용 수정/ 업데이트 고려)를 위해 실시간 조회 또는 최소 일배치 작업을 권장합니다.
+     * - 실시간으로 정보를 제공하지 않는 경우, 신규/수정 공지 내용이 반영되지 않을 수 있으니 서비스 이용 유저에게 홈페이지 공지 사항을 확인하라는 가이드를 제공해주세요.
+     */
+    getCashshopNoticeList(): Promise<CashshopNoticeListDto>;
+    /**
+     * 메이플스토리 캐시샵 공지 게시글 세부 사항을 조회합니다.
+     *
+     * - 공지 정보 API는 데이터 최신화(공지 내용 수정/ 업데이트 고려)를 위해 실시간 조회 또는 최소 일배치 작업을 권장합니다.
+     * - 실시간으로 정보를 제공하지 않는 경우, 신규/수정 공지 내용이 반영되지 않을 수 있으니 서비스 이용 유저에게 홈페이지 공지 사항을 확인하라는 가이드를 제공해주세요.
+     * @param noticeId 공지 식별자
+     */
+    getCashshopNoticeDetail(noticeId: number): Promise<CashshopNoticeDetailDto>;
     /**
      * 서버 점검 정보를 조회합니다.
      */

package/types/maplestory/api/mapleStoryApiError.d.ts

@@ -22,6 +22,7 @@ declare enum MapleStoryApiErrorCode {
     OPENAPI00006 = 5,
     OPENAPI00007 = 6,
     OPENAPI00009 = 7,
-    OPENAPI00010 = 8
+    OPENAPI00010 = 8,
+    OPENAPI00011 = 9
 }
 export { MapleStoryApiError, MapleStoryApiErrorCode };

package/types/maplestory/api/response/character/characterAbilityDtoBody.d.ts

@@ -1,5 +1,5 @@
 type CharacterAbilityDtoBody = {
-    date: string;
+    date: string | null;
     ability_grade: string;
     ability_info: CharacterAbilityInfoDtoBody[];
     remain_fame: number;

package/types/maplestory/api/response/character/characterAndroidEquipmentDtoBody.d.ts

@@ -1,12 +1,12 @@
 type CharacterAndroidEquipmentDtoBody = {
-    date: string;
+    date: string | null;
     android_name: string | null;
     android_nickname: string | null;
     android_icon: string | null;
     android_description: string | null;
     android_hair: CharacterAndroidEquipmentHairDtoBody;
     android_face: CharacterAndroidEquipmentFaceDtoBody;
-    android_skin_name: string | null;
+    android_skin: CharacterAndroidEquipmentSkinDtoBody | null;
     android_cash_item_equipment: CharacterAndroidCashItemEquipmentDtoBody[];
     android_ear_sensor_clip_flag: string | null;
     android_gender: string | null;
@@ -30,6 +30,13 @@ type CharacterAndroidEquipmentFaceDtoBody = {
     mix_color: string | null;
     mix_rate: string;
 };
+type CharacterAndroidEquipmentSkinDtoBody = {
+    skin_name: string;
+    color_style: string | null;
+    hue: number | null;
+    saturation: number | null;
+    brightness: number | null;
+};
 type CharacterAndroidEquipmentPresetDtoBody = {
     android_name: string;
     android_nickname: string;
@@ -37,9 +44,9 @@ type CharacterAndroidEquipmentPresetDtoBody = {
     android_description: string;
     android_gender: string | null;
     android_grade: string;
-    android_skin_name: string;
     android_hair: CharacterAndroidEquipmentHairDtoBody;
     android_face: CharacterAndroidEquipmentFaceDtoBody;
+    android_skin: CharacterAndroidEquipmentSkinDtoBody | null;
     android_ear_sensor_clip_flag: string;
     android_non_humanoid_flag: string;
     android_shop_usable_flag: string;
@@ -66,4 +73,4 @@ type CharacterAndroidCashItemEquipmentColoringPrismDtoBody = {
     saturation: number;
     value: number;
 };
-export type { CharacterAndroidEquipmentDtoBody, CharacterAndroidEquipmentHairDtoBody, CharacterAndroidEquipmentFaceDtoBody, CharacterAndroidEquipmentPresetDtoBody, CharacterAndroidCashItemEquipmentDtoBody, CharacterAndroidCashItemEquipmentOptionDtoBody, CharacterAndroidCashItemEquipmentColoringPrismDtoBody, };
+export type { CharacterAndroidEquipmentDtoBody, CharacterAndroidEquipmentHairDtoBody, CharacterAndroidEquipmentFaceDtoBody, CharacterAndroidEquipmentSkinDtoBody, CharacterAndroidEquipmentPresetDtoBody, CharacterAndroidCashItemEquipmentDtoBody, CharacterAndroidCashItemEquipmentOptionDtoBody, CharacterAndroidCashItemEquipmentColoringPrismDtoBody, };

package/types/maplestory/api/response/character/characterBasicDtoBody.d.ts

@@ -1,5 +1,5 @@
 type CharacterBasicDtoBody = {
-    date: string;
+    date: string | null;
     character_name: string;
     world_name: string;
     character_gender: string;
@@ -10,5 +10,8 @@ type CharacterBasicDtoBody = {
     character_exp_rate: string;
     character_guild_name: string | null;
     character_image: string;
+    character_date_create: string;
+    access_flag: 'true' | 'false';
+    liberation_quest_clear_flag: 'true' | 'false';
 };
 export type { CharacterBasicDtoBody };

package/types/maplestory/api/response/character/characterBeautyEquipmentDtoBody.d.ts

@@ -1,13 +1,13 @@
 type CharacterBeautyEquipmentDtoBody = {
-    date: string;
+    date: string | null;
     character_gender: string;
     character_class: string;
     character_hair: CharacterBeautyEquipmentHairDtoBody;
     character_face: CharacterBeautyEquipmentFaceDtoBody;
-    character_skin_name: string;
+    character_skin: CharacterBeautyEquipmentSkinDtoBody;
     additional_character_hair: CharacterBeautyEquipmentHairDtoBody | null;
     additional_character_face: CharacterBeautyEquipmentFaceDtoBody | null;
-    additional_character_skin_name: string | null;
+    additional_character_skin: CharacterBeautyEquipmentSkinDtoBody | null;
 };
 type CharacterBeautyEquipmentHairDtoBody = {
     hair_name: string;
@@ -21,4 +21,11 @@ type CharacterBeautyEquipmentFaceDtoBody = {
     mix_color: string | null;
     mix_rate: string;
 };
-export type { CharacterBeautyEquipmentDtoBody, CharacterBeautyEquipmentHairDtoBody, CharacterBeautyEquipmentFaceDtoBody, };
+type CharacterBeautyEquipmentSkinDtoBody = {
+    skin_name: string;
+    color_style: string | null;
+    hue: number | null;
+    saturation: number | null;
+    brightness: number | null;
+};
+export type { CharacterBeautyEquipmentDtoBody, CharacterBeautyEquipmentHairDtoBody, CharacterBeautyEquipmentFaceDtoBody, CharacterBeautyEquipmentSkinDtoBody, };

package/types/maplestory/api/response/character/characterCashItemEquipmentDtoBody.d.ts

@@ -1,5 +1,5 @@
 type CharacterCashItemEquipmentDtoBody = {
-    date: string;
+    date: string | null;
     character_gender: string;
     character_class: string;
     preset_no: number;

package/types/maplestory/api/response/character/characterDojangDtoBody.d.ts

@@ -1,5 +1,5 @@
 type CharacterDojangDtoBody = {
-    date: string;
+    date: string | null;
     character_class: string;
     world_name: string;
     dojang_best_floor: number;

package/types/maplestory/api/response/character/characterHexaMatrixDtoBody.d.ts

@@ -1,5 +1,5 @@
 type CharacterHexaMatrixDtoBody = {
-    date: string;
+    date: string | null;
     character_hexa_core_equipment: CharacterHexaMatrixEquipmentDtoBody[];
 };
 type CharacterHexaMatrixEquipmentDtoBody = {

package/types/maplestory/api/response/character/characterHexaMatrixStatDtoBody.d.ts

@@ -1,8 +1,10 @@
 type CharacterHexaMatrixStatDtoBody = {
-    date: string;
+    date: string | null;
     character_class: string;
     character_hexa_stat_core: CharacterHexaMatrixStatCoreDtoBody[];
+    character_hexa_stat_core_2: CharacterHexaMatrixStatCoreDtoBody[];
     preset_hexa_stat_core: CharacterHexaMatrixStatCoreDtoBody[];
+    preset_hexa_stat_core_2: CharacterHexaMatrixStatCoreDtoBody[];
 };
 type CharacterHexaMatrixStatCoreDtoBody = {
     slot_id: string;

package/types/maplestory/api/response/character/characterHyperStatDtoBody.d.ts

@@ -1,5 +1,5 @@
 type CharacterHyperStatDtoBody = {
-    date: string;
+    date: string | null;
     character_class: string;
     use_preset_no: string;
     use_available_hyper_stat: number;

package/types/maplestory/api/response/character/characterItemEquipmentDtoBody.d.ts

@@ -1,5 +1,5 @@
 type CharacterItemEquipmentDtoBody = {
-    date: string;
+    date: string | null;
     character_gender: string;
     character_class: string;
     preset_no: number | null;
@@ -31,7 +31,7 @@ type CharacterItemEquipmentInfoDtoBody = {
     additional_potential_option_2: string | null;
     additional_potential_option_3: string | null;
     equipment_level_increase: number;
-    item_exceptional_option: CharacterItemEquipmentOptionDtoBody;
+    item_exceptional_option: CharacterItemEquipmentExceptionalOptionDtoBody;
     item_add_option: CharacterItemEquipmentAddOptionDtoBody;
     growth_exp: number;
     growth_level: number;
@@ -109,6 +109,7 @@ type CharacterItemEquipmentExceptionalOptionDtoBody = {
     max_mp: string;
     attack_power: string;
     magic_power: string;
+    exceptional_upgrade: number;
 };
 type CharacterItemEquipmentTotalOptionDtoBody = {
     str: string;

package/types/maplestory/api/response/character/characterLinkSkillDtoBody.d.ts

@@ -1,5 +1,5 @@
 type CharacterLinkSkillDtoBody = {
-    date: string;
+    date: string | null;
     character_class: string;
     character_link_skill: CharacterLinkSkillInfoDtoBody[];
     character_link_skill_preset_1: CharacterLinkSkillInfoDtoBody[];
@@ -15,6 +15,7 @@ type CharacterLinkSkillInfoDtoBody = {
     skill_description: string;
     skill_level: number;
     skill_effect: string;
+    skill_effect_next: string | null;
     skill_icon: string;
 };
 export type { CharacterLinkSkillDtoBody, CharacterLinkSkillInfoDtoBody };

package/types/maplestory/api/response/character/characterListDtoBody.d.ts

@@ -0,0 +1,15 @@
+type CharacterListDtoBody = {
+    account_list: CharacterListAccountDtoBody[];
+};
+type CharacterListAccountDtoBody = {
+    account_id: string;
+    character_list: CharacterListAccountCharacterDtoBody[];
+};
+type CharacterListAccountCharacterDtoBody = {
+    ocid: string;
+    character_name: string;
+    world_name: string;
+    character_class: string;
+    character_level: number;
+};
+export type { CharacterListDtoBody, CharacterListAccountDtoBody, CharacterListAccountCharacterDtoBody };

package/types/maplestory/api/response/character/characterPetEquipmentDtoBody.d.ts

@@ -1,5 +1,5 @@
 type CharacterPetEquipmentDtoBody = {
-    date: string;
+    date: string | null;
     pet_1_name: string | null;
     pet_1_nickname: string | null;
     pet_1_icon: string | null;

package/types/maplestory/api/response/character/characterPopularityDtoBody.d.ts

@@ -1,5 +1,5 @@
 type CharacterPopularityDtoBody = {
-    date: string;
+    date: string | null;
     popularity: number;
 };
 export type { CharacterPopularityDtoBody };

package/types/maplestory/api/response/character/characterPropensityDtoBody.d.ts

@@ -1,5 +1,5 @@
 type CharacterPropensityDtoBody = {
-    date: string;
+    date: string | null;
     charisma_level: number;
     sensibility_level: number;
     insight_level: number;