maplestory-openapi 2.4.0 → 2.7.1

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';
@@ -21,8 +22,17 @@ import { CharacterVMatrixDto } from './dto/character/characterVMatrixDto';
 import { GuildBasicDto } from './dto/guild/guildBasicDto';
 import { GuildDto } from './dto/guild/guildDto';
 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';
@@ -32,30 +42,41 @@ import { UnionRankingResponseDto } from './dto/ranking/unionRankingResponseDto';
 import { UnionArtifactDto } from './dto/union/unionArtifactDto';
 import { UnionDto } from './dto/union/unionDto';
 import { UnionRaiderDto } from './dto/union/unionRaiderDto';
-import { PotentialHistoryResponseDto } from './dto/history/potentialHistoryResponseDto';
 /**
  * MapleStory OpenAPI client.<br>
  * This is an implementation of <a href="https://openapi.nexon.com/game/maplestory">MapleStory API</a>
  */
 declare class MapleStoryApi {
     private readonly apiKey;
-    private static BASE_URL;
-    private static kstOffset;
-    timeout: number;
+    private readonly client;
+    private static readonly BASE_URL;
+    private static readonly DEFAULT_TIMEOUT;
+    private static readonly kstOffset;
+    get timeout(): number;
+    set timeout(value: number);
     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 캐릭터 식별자
@@ -64,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 캐릭터 식별자
@@ -74,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 캐릭터 식별자
@@ -84,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 캐릭터 식별자
@@ -94,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 캐릭터 식별자
@@ -104,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 캐릭터 식별자
@@ -114,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 캐릭터 식별자
@@ -124,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 캐릭터 식별자
@@ -134,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 캐릭터 식별자
@@ -144,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 캐릭터 식별자
@@ -154,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 캐릭터 식별자
@@ -164,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 캐릭터 식별자
@@ -174,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 캐릭터 식별자
@@ -184,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 캐릭터 식별자
@@ -206,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 캐릭터 식별자
@@ -216,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 캐릭터 식별자
@@ -226,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 캐릭터 식별자
@@ -236,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 캐릭터 식별자
@@ -246,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 캐릭터 식별자
@@ -256,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 캐릭터 식별자
@@ -266,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 캐릭터 식별자
@@ -276,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 캐릭터 식별자
@@ -286,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 길드 명
@@ -296,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 길드 식별자
@@ -449,11 +493,70 @@ 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>;
     /**
      * 서버 점검 정보를 조회합니다.
      */
     getInspectionInfo(): Promise<InspectionInfoDto>;
-    private buildHeaders;
     /**
      * API 서버의 데이터 갱신 시간에 따라 데이터가 조회 가능한 최신 날짜를 반환합니다.
      *

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

@@ -20,6 +20,9 @@ declare enum MapleStoryApiErrorCode {
     OPENAPI00004 = 3,
     OPENAPI00005 = 4,
     OPENAPI00006 = 5,
-    OPENAPI00007 = 6
+    OPENAPI00007 = 6,
+    OPENAPI00009 = 7,
+    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,5 +1,5 @@
 type CharacterAndroidEquipmentDtoBody = {
-    date: string;
+    date: string | null;
     android_name: string | null;
     android_nickname: string | null;
     android_icon: string | null;

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,5 +1,5 @@
 type CharacterBeautyEquipmentDtoBody = {
-    date: string;
+    date: string | null;
     character_gender: string;
     character_class: string;
     character_hair: CharacterBeautyEquipmentHairDtoBody;

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,5 +1,5 @@
 type CharacterHexaMatrixStatDtoBody = {
-    date: string;
+    date: string | null;
     character_class: string;
     character_hexa_stat_core: CharacterHexaMatrixStatCoreDtoBody[];
     preset_hexa_stat_core: CharacterHexaMatrixStatCoreDtoBody[];

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;

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;

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

@@ -1,14 +1,19 @@
 type CharacterSetEffectDtoBody = {
-    date: string;
-    set_effect: CharacterSetEffectInfoDtoBody[];
+    date: string | null;
+    set_effect: CharacterSetEffectSetDtoBody[];
 };
-type CharacterSetEffectInfoDtoBody = {
+type CharacterSetEffectSetDtoBody = {
     set_name: string;
     total_set_count: number;
-    set_effect_info: CharacterSetEffectOptionInfoDtoBody[];
+    set_effect_info: CharacterSetEffectInfoDtoBody[];
+    set_option_full: CharacterSetEffectOptionFullDtoBody[];
+};
+type CharacterSetEffectInfoDtoBody = {
+    set_count: number;
+    set_option: string;
 };
-type CharacterSetEffectOptionInfoDtoBody = {
+type CharacterSetEffectOptionFullDtoBody = {
     set_count: number;
     set_option: string;
 };
-export { CharacterSetEffectDtoBody, CharacterSetEffectInfoDtoBody, CharacterSetEffectOptionInfoDtoBody, };
+export { CharacterSetEffectDtoBody, CharacterSetEffectSetDtoBody, CharacterSetEffectInfoDtoBody, CharacterSetEffectOptionFullDtoBody, };

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

@@ -1,5 +1,5 @@
 type CharacterSkillDtoBody = {
-    date: string;
+    date: string | null;
     character_class: string;
     character_skill_grade: string;
     character_skill: CharacterSkillInfoDtoBody[];
@@ -9,6 +9,7 @@ type CharacterSkillInfoDtoBody = {
     skill_description: string;
     skill_level: number;
     skill_effect: string;
+    skill_effect_next: string | null;
     skill_icon: string;
 };
 export type { CharacterSkillDtoBody, CharacterSkillInfoDtoBody };