maplestory-openapi 2.13.1 → 3.1.0

package/types/maplestory/api/kms/dto/union/unionChampion.d.ts

@@ -0,0 +1,55 @@
+import { UnionChampionBadgeInfoBody, UnionChampionBody, UnionChampionInfoBody } from '../../response/union/unionChampionBody';
+/**
+ * 유니온 챔피언 정보
+ */
+export declare class UnionChampionDto {
+    /**
+     * 조회 기준일 (KST, 일 단위 데이터로 시, 분은 일괄 0으로 표기)
+     */
+    date: Date | null;
+    /**
+     * 유니온 챔피언 정보
+     */
+    unionChampion: UnionChampionInfoDto[];
+    /**
+     * 유니온 챔피언 휘장 정보
+     */
+    championBadgeTotalInfo: UnionChampionBadgeInfoDto[];
+    constructor(obj: UnionChampionBody);
+}
+/**
+ * 유니온 챔피언 휘장 정보
+ */
+export declare class UnionChampionBadgeInfoDto {
+    /**
+     * 유니온 챔피언 휘장 효과
+     */
+    stat: string;
+    constructor(obj: UnionChampionBadgeInfoBody);
+}
+/**
+ * 유니온 챔피언 상세 정보
+ */
+export declare class UnionChampionInfoDto {
+    /**
+     * 유니온 챔피언 캐릭터 명
+     */
+    championName: string;
+    /**
+     * 유니온 챔피언 슬롯
+     */
+    championSlot: number;
+    /**
+     * 유니온 챔피언 등급
+     */
+    championGrade: string;
+    /**
+     * 유니온 챔피언 캐릭터의 직업
+     */
+    championClass: string;
+    /**
+     * 챔피언 휘장 효과
+     */
+    championBadgeInfo: UnionChampionBadgeInfoDto[];
+    constructor(obj: UnionChampionInfoBody);
+}

package/types/maplestory/api/kms/dto/union/unionRaider.d.ts

@@ -0,0 +1,142 @@
+import * as base from '../../../common/dto/union/unionRaider';
+import { UnionRaiderBlockBody, UnionRaiderBlockControlPointBody, UnionRaiderBlockPositionBody, UnionRaiderBody, UnionRaiderInnerStatBody, UnionRaiderPresetBody } from '../../response/union/unionRaiderBody';
+/**
+ * 유니온 공격대 정보
+ */
+export declare class UnionRaiderDto extends base.UnionRaiderDto {
+    /**
+     * 조회 기준일 (KST, 일 단위 데이터로 시, 분은 일괄 0으로 표기)
+     */
+    date: Date | null;
+    /**
+     * 유니온 공격대원 효과
+     */
+    unionRaiderStat: string[];
+    /**
+     * 유니온 공격대 점령 효과
+     */
+    unionOccupiedStat: string[];
+    /**
+     * 유니온 공격대 배치
+     */
+    unionInnerStat: UnionRaiderInnerStatDto[];
+    /**
+     * 유니온 블록 정보
+     */
+    unionBlock: UnionRaiderBlockDto[];
+    /**
+     * 적용 중인 프리셋 번호
+     */
+    usePresetNo: number;
+    /**
+     * 유니온 프리셋 1번 정보
+     */
+    unionRaiderPreset1: UnionRaiderPresetDto | null;
+    /**
+     * 유니온 프리셋 2번 정보
+     */
+    unionRaiderPreset2: UnionRaiderPresetDto | null;
+    /**
+     * 유니온 프리셋 3번 정보
+     */
+    unionRaiderPreset3: UnionRaiderPresetDto | null;
+    /**
+     * 유니온 프리셋 4번 정보
+     */
+    unionRaiderPreset4: UnionRaiderPresetDto | null;
+    /**
+     * 유니온 프리셋 5번 정보
+     */
+    unionRaiderPreset5: UnionRaiderPresetDto | null;
+    constructor(obj: UnionRaiderBody);
+}
+/**
+ * 유니온 공격대 배치 정보
+ */
+export declare class UnionRaiderInnerStatDto extends base.UnionRaiderInnerStatDto {
+    /**
+     * 공격대 배치 위치 (11시 방향부터 시계 방향 순서대로 0~7)
+     */
+    statFieldId: string;
+    /**
+     * 해당 지역 점령 효과
+     */
+    statFieldEffect: string;
+    constructor(obj: UnionRaiderInnerStatBody);
+}
+/**
+ * 유니온 블록이 차지하고 있는 영역 좌표들
+ */
+export declare class UnionRaiderBlockPositionDto extends base.UnionRaiderBlockPositionDto {
+    /**
+     * 블록 X좌표
+     */
+    x: number;
+    /**
+     * 블록 Y좌표
+     */
+    y: number;
+    constructor(obj: UnionRaiderBlockPositionBody);
+}
+/**
+ * 유니온 블록 기준점 좌표 정보
+ */
+export declare class UnionRaiderBlockControlPointDto extends base.UnionRaiderBlockControlPointDto {
+    /**
+     * 블록 기준점 X좌표
+     */
+    x: number;
+    /**
+     * 블록 기준점 Y좌표
+     */
+    y: number;
+    constructor(obj: UnionRaiderBlockControlPointBody);
+}
+/**
+ * 유니온 블록 정보
+ */
+export declare class UnionRaiderBlockDto extends base.UnionRaiderBlockDto {
+    /**
+     * 블록 모양 (전사, 마법사, 궁수, 도적, 해적, 메이플m, 하이브리드)
+     */
+    blockType: string;
+    /**
+     * 블록 해당 캐릭터 직업
+     */
+    blockClass: string;
+    /**
+     * 블록 해당 캐릭터 레벨
+     */
+    blockLevel: string;
+    /**
+     * 블록 기준점 좌표
+     */
+    blockControlPoint: UnionRaiderBlockControlPointDto;
+    /**
+     * 블록이 차지하고 있는 영역 좌표들 (null:미 배치 시)
+     */
+    blockPosition: UnionRaiderBlockPositionDto[] | null;
+    constructor(obj: UnionRaiderBlockBody);
+}
+/**
+ * 유니온 프리셋 정보
+ */
+export declare class UnionRaiderPresetDto extends base.UnionRaiderPresetDto {
+    /**
+     * 유니온 공격대원 효과
+     */
+    unionRaiderStat: string[];
+    /**
+     * 유니온 공격대 점령 효과
+     */
+    unionOccupiedStat: string[];
+    /**
+     * 유니온 공격대 배치
+     */
+    unionInnerStat: UnionRaiderInnerStatDto[];
+    /**
+     * 유니온 블록 정보
+     */
+    unionBlock: UnionRaiderBlockDto[];
+    constructor(obj: UnionRaiderPresetBody);
+}

package/types/maplestory/api/kms/index.d.ts

@@ -0,0 +1,47 @@
+export * from './mapleStoryApi';
+export * from './dto/character/character';
+export * from './dto/character/characterAbility';
+export * from './dto/character/characterAndroidEquipment';
+export * from './dto/character/characterBasic';
+export * from './dto/character/characterBeautyEquipment';
+export * from './dto/character/characterCashItemEquipment';
+export * from './dto/character/characterDojang';
+export * from './dto/character/characterHexaMatrix';
+export * from './dto/character/characterHexaMatrixStat';
+export * from './dto/character/characterHyperStat';
+export * from './dto/character/characterImage';
+export * from './dto/character/characterItemEquipment';
+export * from './dto/character/characterLinkSkill';
+export * from './dto/character/characterList';
+export * from './dto/character/characterPetEquipment';
+export * from './dto/character/characterPopularity';
+export * from './dto/character/characterPropensity';
+export * from './dto/character/characterSetEffect';
+export * from './dto/character/characterSkill';
+export * from './dto/character/characterStat';
+export * from './dto/character/characterSymbolEquipment';
+export * from './dto/character/characterVMatrix';
+export * from './dto/guild/guild';
+export * from './dto/guild/guildBasic';
+export * from './dto/history/cubeHistory';
+export * from './dto/history/potentialHistory';
+export * from './dto/history/starforceHistory';
+export * from './dto/notice/cashshopNoticeDetail';
+export * from './dto/notice/cashshopNoticeList';
+export * from './dto/notice/eventNoticeDetail';
+export * from './dto/notice/eventNoticeList';
+export * from './dto/notice/noticeDetail';
+export * from './dto/notice/noticeList';
+export * from './dto/notice/updateNoticeDetail';
+export * from './dto/notice/updateNoticeList';
+export * from './dto/ranking/achievementRanking';
+export * from './dto/ranking/dojangRanking';
+export * from './dto/ranking/guildRanking';
+export * from './dto/ranking/overallRanking';
+export * from './dto/ranking/theSeedRanking';
+export * from './dto/ranking/unionRanking';
+export * from './dto/union/union';
+export * from './dto/union/unionArtifact';
+export * from './dto/union/unionChampion';
+export * from './dto/union/unionRaider';
+export * from './dto/inspectionInfo';

package/types/maplestory/api/{mapleStoryApi.d.ts → kms/mapleStoryApi.d.ts}

@@ -1,60 +1,59 @@
-import { CharacterAbilityDto } from './dto/character/characterAbilityDto';
-import { CharacterAndroidEquipmentDto } from './dto/character/characterAndroidEquipmentDto';
-import { CharacterBasicDto } from './dto/character/characterBasicDto';
-import { CharacterBeautyEquipmentDto } from './dto/character/characterBeautyEquipmentDto';
-import { CharacterCashItemEquipmentDto } from './dto/character/characterCashItemEquipmentDto';
-import { CharacterDojangDto } from './dto/character/characterDojangDto';
-import { CharacterDto } from './dto/character/characterDto';
-import { CharacterHexaMatrixDto } from './dto/character/characterHexaMatrixDto';
-import { CharacterHexaMatrixStatDto } from './dto/character/characterHexaMatrixStatDto';
-import { CharacterHyperStatDto } from './dto/character/characterHyperStatDto';
-import { CharacterImageAction, CharacterImageDto, CharacterImageEmotion, CharacterImageWeaponMotion } from './dto/character/characterImageDto';
-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';
-import { CharacterSetEffectDto } from './dto/character/characterSetEffectDto';
-import { CharacterSkillDto } from './dto/character/characterSkillDto';
-import { CharacterStatDto } from './dto/character/characterStatDto';
-import { CharacterSymbolEquipmentDto } from './dto/character/characterSymbolEquipmentDto';
-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';
-import { OverallRankingResponseDto } from './dto/ranking/overallRankingResponseDto';
-import { TheSeedRankingResponseDto } from './dto/ranking/theSeedRankingResponseDto';
-import { UnionRankingResponseDto } from './dto/ranking/unionRankingResponseDto';
-import { UnionArtifactDto } from './dto/union/unionArtifactDto';
-import { UnionChampionDto } from './dto/union/unionChampionDto';
-import { UnionDto } from './dto/union/unionDto';
-import { UnionRaiderDto } from './dto/union/unionRaiderDto';
+import { CharacterDto } from './dto/character/character';
+import { CharacterAbilityDto } from './dto/character/characterAbility';
+import { CharacterAndroidEquipmentDto } from './dto/character/characterAndroidEquipment';
+import { CharacterBasicDto } from './dto/character/characterBasic';
+import { CharacterBeautyEquipmentDto } from './dto/character/characterBeautyEquipment';
+import { CharacterCashItemEquipmentDto } from './dto/character/characterCashItemEquipment';
+import { CharacterDojangDto } from './dto/character/characterDojang';
+import { CharacterHexaMatrixDto } from './dto/character/characterHexaMatrix';
+import { CharacterHexaMatrixStatDto } from './dto/character/characterHexaMatrixStat';
+import { CharacterHyperStatDto } from './dto/character/characterHyperStat';
+import { CharacterImageDto } from './dto/character/characterImage';
+import { CharacterItemEquipmentDto } from './dto/character/characterItemEquipment';
+import { CharacterLinkSkillDto } from './dto/character/characterLinkSkill';
+import { CharacterListDto } from './dto/character/characterList';
+import { CharacterPetEquipmentDto } from './dto/character/characterPetEquipment';
+import { CharacterPopularityDto } from './dto/character/characterPopularity';
+import { CharacterPropensityDto } from './dto/character/characterPropensity';
+import { CharacterSetEffectDto } from './dto/character/characterSetEffect';
+import { CharacterSkillDto } from './dto/character/characterSkill';
+import { CharacterStatDto } from './dto/character/characterStat';
+import { CharacterSymbolEquipmentDto } from './dto/character/characterSymbolEquipment';
+import { CharacterVMatrixDto } from './dto/character/characterVMatrix';
+import { GuildDto } from './dto/guild/guild';
+import { GuildBasicDto } from './dto/guild/guildBasic';
+import { CubeHistoryResponseDto } from './dto/history/cubeHistory';
+import { PotentialHistoryResponseDto } from './dto/history/potentialHistory';
+import { StarforceHistoryResponseDto } from './dto/history/starforceHistory';
+import { InspectionInfoDto } from './dto/inspectionInfo';
+import { CashshopNoticeDetailDto } from './dto/notice/cashshopNoticeDetail';
+import { CashshopNoticeListDto } from './dto/notice/cashshopNoticeList';
+import { EventNoticeDetailDto } from './dto/notice/eventNoticeDetail';
+import { EventNoticeListDto } from './dto/notice/eventNoticeList';
+import { NoticeDetailDto } from './dto/notice/noticeDetail';
+import { NoticeListDto } from './dto/notice/noticeList';
+import { UpdateNoticeDetailDto } from './dto/notice/updateNoticeDetail';
+import { UpdateNoticeListDto } from './dto/notice/updateNoticeList';
+import { AchievementRankingResponseDto } from './dto/ranking/achievementRanking';
+import { DojangRankingResponseDto } from './dto/ranking/dojangRanking';
+import { GuildRankingResponseDto } from './dto/ranking/guildRanking';
+import { OverallRankingResponseDto } from './dto/ranking/overallRanking';
+import { TheSeedRankingResponseDto } from './dto/ranking/theSeedRanking';
+import { UnionRankingResponseDto } from './dto/ranking/unionRanking';
+import { UnionDto } from './dto/union/union';
+import { UnionArtifactDto } from './dto/union/unionArtifact';
+import { UnionChampionDto } from './dto/union/unionChampion';
+import { UnionRaiderDto } from './dto/union/unionRaider';
+import { CharacterImageAction, CharacterImageEmotion, CharacterImageWeaponMotion } from '../common/enum/characterImage';
+import { DateOptions } from '../common/mapleStoryApi';
+import * as base from '../common/mapleStoryApi';
 /**
- * MapleStory OpenAPI client.<br>
+ * MapleStory OpenAPI client for KMS.<br>
  * This is an implementation of <a href="https://openapi.nexon.com/game/maplestory">MapleStory API</a>
  */
-declare class MapleStoryApi {
-    private readonly apiKey;
-    private readonly client;
-    private static readonly BASE_URL;
-    private static readonly DEFAULT_TIMEOUT;
-    get timeout(): number;
-    set timeout(value: number);
+export declare class MapleStoryApi extends base.MapleStoryApi {
+    protected subUrl: string;
+    protected timezoneOffset: number;
     constructor(apiKey: string);
     /**
      * 캐릭터 식별자(ocid)를 조회합니다.
@@ -62,6 +61,7 @@ declare class MapleStoryApi {
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
      * @param characterName    캐릭터 명
      */
@@ -71,6 +71,7 @@ declare class MapleStoryApi {
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      */
     getCharacterList(): Promise<CharacterListDto>;
     /**
@@ -79,6 +80,7 @@ declare class MapleStoryApi {
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
@@ -90,6 +92,7 @@ declare class MapleStoryApi {
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
      * @param ocid 캐릭터 식별자
      * @param imageOptions 캐릭터 외형 파라미터
@@ -102,6 +105,7 @@ declare class MapleStoryApi {
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
@@ -113,6 +117,7 @@ declare class MapleStoryApi {
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
@@ -124,6 +129,7 @@ declare class MapleStoryApi {
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
@@ -135,6 +141,7 @@ declare class MapleStoryApi {
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
@@ -146,6 +153,7 @@ declare class MapleStoryApi {
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
@@ -157,6 +165,7 @@ declare class MapleStoryApi {
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
@@ -168,6 +177,7 @@ declare class MapleStoryApi {
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
@@ -179,6 +189,7 @@ declare class MapleStoryApi {
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
@@ -190,6 +201,7 @@ declare class MapleStoryApi {
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
@@ -201,6 +213,7 @@ declare class MapleStoryApi {
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
@@ -212,6 +225,7 @@ declare class MapleStoryApi {
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
@@ -223,6 +237,7 @@ declare class MapleStoryApi {
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
@@ -234,20 +249,10 @@ declare class MapleStoryApi {
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
      * @param ocid 캐릭터 식별자
-     * @param characterSkillGrade 조회하고자 하는 전직 차수
-     *  - 0: 0차 스킬 및 제로 공용스킬
-     *  - 1: 1차 스킬
-     *  - 1.5: 1.5차 스킬
-     *  - 2: 2차 스킬
-     *  - 2.5: 2.5차 스킬
-     *  - 3: 3차 스킬
-     *  - 4: 4차 스킬 및 제로 알파/베타 스킬
-     *  - hyperpassive: 하이퍼 패시브 스킬
-     *  - hyperactive: 하이퍼 액티브 스킬
-     *  - 5: 5차 스킬
-     *  - 6: 6차 스킬
+     * @param characterSkillGrade 조회하고자 하는 전직 차수 <a href="https://openapi.nexon.com/ko/game/maplestory/?id=14">Available values</a>
      *  @param dateOptions 조회 기준일 (KST)
      */
     getCharacterSkill(ocid: string, characterSkillGrade: string, dateOptions?: DateOptions): Promise<CharacterSkillDto>;
@@ -257,6 +262,7 @@ declare class MapleStoryApi {
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
@@ -268,6 +274,7 @@ declare class MapleStoryApi {
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
@@ -279,6 +286,7 @@ declare class MapleStoryApi {
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
@@ -290,6 +298,7 @@ declare class MapleStoryApi {
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
@@ -301,6 +310,7 @@ declare class MapleStoryApi {
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
@@ -312,6 +322,7 @@ declare class MapleStoryApi {
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
@@ -323,6 +334,7 @@ declare class MapleStoryApi {
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
@@ -334,6 +346,7 @@ declare class MapleStoryApi {
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
@@ -346,6 +359,7 @@ declare class MapleStoryApi {
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
@@ -357,6 +371,7 @@ declare class MapleStoryApi {
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
      * @param guildName 길드 명
      * @param worldName 월드 명
@@ -368,6 +383,7 @@ declare class MapleStoryApi {
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
      * @param guildId 길드 식별자
      * @param dateOptions 조회 기준일 (KST)
@@ -997,15 +1013,4 @@ type AchievementRankingApiFilterOptions = {
      */
     page?: number;
 };
-type DateOptions = {
-    year: number;
-    month: number;
-    day: number;
-};
-type MapleStoryErrorBody = {
-    error: {
-        name: string;
-        message: string;
-    };
-};
-export { MapleStoryApi, MapleStoryErrorBody };
+export {};

package/types/maplestory/api/kms/response/character/characterAbilityBody.d.ts

@@ -0,0 +1,19 @@
+export type CharacterAbilityBody = {
+    date: string | null;
+    ability_grade: string | null;
+    ability_info: CharacterAbilityInfoBody[];
+    remain_fame: number | null;
+    preset_no: number | null;
+    ability_preset_1: CharacterAbilityPresetBody | null;
+    ability_preset_2: CharacterAbilityPresetBody | null;
+    ability_preset_3: CharacterAbilityPresetBody | null;
+};
+export type CharacterAbilityInfoBody = {
+    ability_no: string;
+    ability_grade: string;
+    ability_value: string;
+};
+export type CharacterAbilityPresetBody = {
+    ability_preset_grade: string;
+    ability_info: CharacterAbilityInfoBody[];
+};