maplestory-openapi 3.8.1 → 3.9.0

package/dist/cjs/maplestory/api/kms/dto/character/characterPetEquipment.js

@@ -312,9 +312,13 @@ class CharacterPetEquipmentItemDto extends characterPetEquipment.CharacterPetEqu
      * 아이템 외형 아이콘
      */
     itemShapeIcon;
+    /**
+     * 아이템 만료시간 (KST, 분 단위는 일괄 0으로 표기, null:무제한, -1:미착용)
+     */
+    itemDateExpire;
     constructor(obj) {
         super();
-        const { item_name, item_icon, item_description, item_option, scroll_upgrade, scroll_upgradable, item_shape, item_shape_icon, } = obj;
+        const { item_name, item_icon, item_description, item_option, scroll_upgrade, scroll_upgradable, item_shape, item_shape_icon, item_date_expire, } = obj;
         this.itemName = item_name;
         this.itemIcon = item_icon;
         this.itemDescription = item_description;
@@ -323,6 +327,7 @@ class CharacterPetEquipmentItemDto extends characterPetEquipment.CharacterPetEqu
         this.scrollUpgradable = scroll_upgradable;
         this.itemShape = item_shape;
         this.itemShapeIcon = item_shape_icon;
+        this.itemDateExpire = item_date_expire ? new Date(item_date_expire) : null;
     }
 }
 

package/dist/cjs/maplestory/api/kms/dto/character/characterRingReserveSkillEquipment.js

@@ -0,0 +1,44 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * 캐릭터 예비 특수 반지 장착 정보
+ */
+class CharacterRingReserveSkillEquipmentDto {
+    /**
+     * 조회 기준일 (KST, 일 단위 데이터로 시, 분은 일괄 0으로 표기)
+     */
+    date;
+    /**
+     * 캐릭터 직업
+     */
+    characterClass;
+    /**
+     * 예비 특수 반지 슬롯에 장착한 특수 반지
+     */
+    specialRingReserveName;
+    /**
+     * 예비 특수 반지 슬롯에 장착한 특수 반지 레벨
+     */
+    specialRingReserveLevel;
+    /**
+     * 예비 특수 반지 슬롯에 장착한 특수 반지 아이콘
+     */
+    specialRingReserveIcon;
+    /**
+     * 예비 특수 반지 슬롯에 장착한 특수 반지 설명
+     */
+    specialRingReserveDescription;
+    constructor(obj) {
+        const { date, character_class, special_ring_reserve_name, special_ring_reserve_level, special_ring_reserve_icon, special_ring_reserve_description, } = obj;
+        this.date = date ? new Date(date) : null;
+        this.characterClass = character_class;
+        this.specialRingReserveName = special_ring_reserve_name;
+        this.specialRingReserveLevel = special_ring_reserve_level;
+        this.specialRingReserveIcon = special_ring_reserve_icon;
+        this.specialRingReserveDescription = special_ring_reserve_description;
+    }
+}
+
+exports.CharacterRingReserveSkillEquipmentDto = CharacterRingReserveSkillEquipmentDto;

package/dist/cjs/maplestory/api/kms/kms.js

@@ -25,6 +25,8 @@ var characterSetEffect = require('./dto/character/characterSetEffect.js');
 var characterSkill = require('./dto/character/characterSkill.js');
 var characterStat = require('./dto/character/characterStat.js');
 var characterSymbolEquipment = require('./dto/character/characterSymbolEquipment.js');
+var characterRingExchangeSkillEquipment = require('./dto/character/characterRingExchangeSkillEquipment.js');
+var characterRingReserveSkillEquipment = require('./dto/character/characterRingReserveSkillEquipment.js');
 var characterVMatrix = require('./dto/character/characterVMatrix.js');
 var guild = require('./dto/guild/guild.js');
 var guildBasic = require('./dto/guild/guildBasic.js');
@@ -121,6 +123,8 @@ exports.CharacterFinalStatDto = characterStat.CharacterFinalStatDto;
 exports.CharacterStatDto = characterStat.CharacterStatDto;
 exports.CharacterSymbolEquipmentDto = characterSymbolEquipment.CharacterSymbolEquipmentDto;
 exports.CharacterSymbolEquipmentInfoDto = characterSymbolEquipment.CharacterSymbolEquipmentInfoDto;
+exports.CharacterRingExchangeSkillEquipmentDto = characterRingExchangeSkillEquipment.CharacterRingExchangeSkillEquipmentDto;
+exports.CharacterRingReserveSkillEquipmentDto = characterRingReserveSkillEquipment.CharacterRingReserveSkillEquipmentDto;
 exports.CharacterVMatrixCodeEquipmentDto = characterVMatrix.CharacterVMatrixCodeEquipmentDto;
 exports.CharacterVMatrixDto = characterVMatrix.CharacterVMatrixDto;
 exports.GuildDto = guild.GuildDto;

package/dist/cjs/maplestory/api/kms/mapleStoryApi.js

@@ -23,6 +23,7 @@ var characterPetEquipment = require('./dto/character/characterPetEquipment.js');
 var characterPopularity = require('./dto/character/characterPopularity.js');
 var characterPropensity = require('./dto/character/characterPropensity.js');
 var characterRingExchangeSkillEquipment = require('./dto/character/characterRingExchangeSkillEquipment.js');
+var characterRingReserveSkillEquipment = require('./dto/character/characterRingReserveSkillEquipment.js');
 var characterSetEffect = require('./dto/character/characterSetEffect.js');
 var characterSkill = require('./dto/character/characterSkill.js');
 var characterStat = require('./dto/character/characterStat.js');
@@ -827,7 +828,8 @@ class MapleStoryApi extends mapleStoryApi.MapleStoryApi {
     /**
      * 링 익스체인지 스킬 등록 장비를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
-     * - 2025년 8월 21일 데이터부터 조회할 수 있습니다.
+     * - 2025년 08월 21일부터 2026년 3월 18일까지의 데이터를 조회할 수 있습니다.
+     * - 2026년 3월 19일부터는 예비 특수 반지 장착 정보 조회를 사용해주세요.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (8월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
@@ -856,6 +858,38 @@ class MapleStoryApi extends mapleStoryApi.MapleStoryApi {
         }
         return new characterRingExchangeSkillEquipment.CharacterRingExchangeSkillEquipmentDto(data);
     }
+    /**
+     * 예비 특수 반지 장착 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
+     * - 2026년 3월 19일 데이터부터 조회할 수 있습니다.
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (3월 20일 데이터 조회 시, 20일 00시부터 21일 00시 사이 데이터가 조회 됩니다.)
+     * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
+     *
+     * @param ocid 캐릭터 식별자
+     * @param dateOptions 조회 기준일 (KST)
+     */
+    async getCharacterRingReserveSkillEquipment(ocid, dateOptions) {
+        const path = `${this.subUrl}/v1/character/ring-reserve-skill-equipment`;
+        const date = dateOptions
+            ? this.toDateString(dateOptions, {
+                year: 2026,
+                month: 3,
+                day: 19,
+            })
+            : undefined;
+        const query = {
+            ocid: ocid,
+            date: date,
+        };
+        const { data } = await this.client.get(path, {
+            params: query,
+        });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
+        return new characterRingReserveSkillEquipment.CharacterRingReserveSkillEquipmentDto(data);
+    }
     //#endregion
     //#region 유니온 정보 조회
     /**

package/dist/esm/maplestory/api/kms/dto/character/characterPetEquipment.js

@@ -308,9 +308,13 @@ class CharacterPetEquipmentItemDto extends CharacterPetEquipmentItemDto$1 {
      * 아이템 외형 아이콘
      */
     itemShapeIcon;
+    /**
+     * 아이템 만료시간 (KST, 분 단위는 일괄 0으로 표기, null:무제한, -1:미착용)
+     */
+    itemDateExpire;
     constructor(obj) {
         super();
-        const { item_name, item_icon, item_description, item_option, scroll_upgrade, scroll_upgradable, item_shape, item_shape_icon, } = obj;
+        const { item_name, item_icon, item_description, item_option, scroll_upgrade, scroll_upgradable, item_shape, item_shape_icon, item_date_expire, } = obj;
         this.itemName = item_name;
         this.itemIcon = item_icon;
         this.itemDescription = item_description;
@@ -319,6 +323,7 @@ class CharacterPetEquipmentItemDto extends CharacterPetEquipmentItemDto$1 {
         this.scrollUpgradable = scroll_upgradable;
         this.itemShape = item_shape;
         this.itemShapeIcon = item_shape_icon;
+        this.itemDateExpire = item_date_expire ? new Date(item_date_expire) : null;
     }
 }
 

package/dist/esm/maplestory/api/kms/dto/character/characterRingReserveSkillEquipment.js

@@ -0,0 +1,40 @@
+/**
+ * 캐릭터 예비 특수 반지 장착 정보
+ */
+class CharacterRingReserveSkillEquipmentDto {
+    /**
+     * 조회 기준일 (KST, 일 단위 데이터로 시, 분은 일괄 0으로 표기)
+     */
+    date;
+    /**
+     * 캐릭터 직업
+     */
+    characterClass;
+    /**
+     * 예비 특수 반지 슬롯에 장착한 특수 반지
+     */
+    specialRingReserveName;
+    /**
+     * 예비 특수 반지 슬롯에 장착한 특수 반지 레벨
+     */
+    specialRingReserveLevel;
+    /**
+     * 예비 특수 반지 슬롯에 장착한 특수 반지 아이콘
+     */
+    specialRingReserveIcon;
+    /**
+     * 예비 특수 반지 슬롯에 장착한 특수 반지 설명
+     */
+    specialRingReserveDescription;
+    constructor(obj) {
+        const { date, character_class, special_ring_reserve_name, special_ring_reserve_level, special_ring_reserve_icon, special_ring_reserve_description, } = obj;
+        this.date = date ? new Date(date) : null;
+        this.characterClass = character_class;
+        this.specialRingReserveName = special_ring_reserve_name;
+        this.specialRingReserveLevel = special_ring_reserve_level;
+        this.specialRingReserveIcon = special_ring_reserve_icon;
+        this.specialRingReserveDescription = special_ring_reserve_description;
+    }
+}
+
+export { CharacterRingReserveSkillEquipmentDto };

package/dist/esm/maplestory/api/kms/kms.js

@@ -21,6 +21,8 @@ export { CharacterSetEffectDto, CharacterSetEffectInfoDto, CharacterSetEffectOpt
 export { CharacterSkillDto, CharacterSkillInfoDto } from './dto/character/characterSkill.js';
 export { CharacterFinalStatDto, CharacterStatDto } from './dto/character/characterStat.js';
 export { CharacterSymbolEquipmentDto, CharacterSymbolEquipmentInfoDto } from './dto/character/characterSymbolEquipment.js';
+export { CharacterRingExchangeSkillEquipmentDto } from './dto/character/characterRingExchangeSkillEquipment.js';
+export { CharacterRingReserveSkillEquipmentDto } from './dto/character/characterRingReserveSkillEquipment.js';
 export { CharacterVMatrixCodeEquipmentDto, CharacterVMatrixDto } from './dto/character/characterVMatrix.js';
 export { GuildDto } from './dto/guild/guild.js';
 export { GuildBasicDto, GuildSkillDto } from './dto/guild/guildBasic.js';

package/dist/esm/maplestory/api/kms/mapleStoryApi.js

@@ -19,6 +19,7 @@ import { CharacterPetEquipmentDto } from './dto/character/characterPetEquipment.
 import { CharacterPopularityDto } from './dto/character/characterPopularity.js';
 import { CharacterPropensityDto } from './dto/character/characterPropensity.js';
 import { CharacterRingExchangeSkillEquipmentDto } from './dto/character/characterRingExchangeSkillEquipment.js';
+import { CharacterRingReserveSkillEquipmentDto } from './dto/character/characterRingReserveSkillEquipment.js';
 import { CharacterSetEffectDto } from './dto/character/characterSetEffect.js';
 import { CharacterSkillDto } from './dto/character/characterSkill.js';
 import { CharacterStatDto } from './dto/character/characterStat.js';
@@ -818,7 +819,8 @@ class MapleStoryApi extends MapleStoryApi$1 {
     /**
      * 링 익스체인지 스킬 등록 장비를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
-     * - 2025년 8월 21일 데이터부터 조회할 수 있습니다.
+     * - 2025년 08월 21일부터 2026년 3월 18일까지의 데이터를 조회할 수 있습니다.
+     * - 2026년 3월 19일부터는 예비 특수 반지 장착 정보 조회를 사용해주세요.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (8월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
@@ -847,6 +849,38 @@ class MapleStoryApi extends MapleStoryApi$1 {
         }
         return new CharacterRingExchangeSkillEquipmentDto(data);
     }
+    /**
+     * 예비 특수 반지 장착 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
+     * - 2026년 3월 19일 데이터부터 조회할 수 있습니다.
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (3월 20일 데이터 조회 시, 20일 00시부터 21일 00시 사이 데이터가 조회 됩니다.)
+     * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
+     *
+     * @param ocid 캐릭터 식별자
+     * @param dateOptions 조회 기준일 (KST)
+     */
+    async getCharacterRingReserveSkillEquipment(ocid, dateOptions) {
+        const path = `${this.subUrl}/v1/character/ring-reserve-skill-equipment`;
+        const date = dateOptions
+            ? this.toDateString(dateOptions, {
+                year: 2026,
+                month: 3,
+                day: 19,
+            })
+            : undefined;
+        const query = {
+            ocid: ocid,
+            date: date,
+        };
+        const { data } = await this.client.get(path, {
+            params: query,
+        });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
+        return new CharacterRingReserveSkillEquipmentDto(data);
+    }
     //#endregion
     //#region 유니온 정보 조회
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "maplestory-openapi",
-  "version": "3.8.1",
+  "version": "3.9.0",
   "description": "This JavaScript library enables the use of the MapleStory OpenAPI of Nexon.",
   "keywords": [
     "maplestory",

package/types/maplestory/api/kms/dto/character/characterPetEquipment.d.ts

@@ -226,5 +226,9 @@ export declare class CharacterPetEquipmentItemDto extends base.CharacterPetEquip
      * 아이템 외형 아이콘
      */
     itemShapeIcon: string | null;
+    /**
+     * 아이템 만료시간 (KST, 분 단위는 일괄 0으로 표기, null:무제한, -1:미착용)
+     */
+    itemDateExpire: Date | null;
     constructor(obj: CharacterPetEquipmentItemBody);
 }

package/types/maplestory/api/kms/dto/character/characterRingReserveSkillEquipment.d.ts

@@ -0,0 +1,31 @@
+import { CharacterRingReserveSkillEquipmentBody } from '../../response/character/characterRingReserveSkillEquipmentBody';
+/**
+ * 캐릭터 예비 특수 반지 장착 정보
+ */
+export declare class CharacterRingReserveSkillEquipmentDto {
+    /**
+     * 조회 기준일 (KST, 일 단위 데이터로 시, 분은 일괄 0으로 표기)
+     */
+    date: Date | null;
+    /**
+     * 캐릭터 직업
+     */
+    characterClass: string;
+    /**
+     * 예비 특수 반지 슬롯에 장착한 특수 반지
+     */
+    specialRingReserveName: string | null;
+    /**
+     * 예비 특수 반지 슬롯에 장착한 특수 반지 레벨
+     */
+    specialRingReserveLevel: number | null;
+    /**
+     * 예비 특수 반지 슬롯에 장착한 특수 반지 아이콘
+     */
+    specialRingReserveIcon: string | null;
+    /**
+     * 예비 특수 반지 슬롯에 장착한 특수 반지 설명
+     */
+    specialRingReserveDescription: string | null;
+    constructor(obj: CharacterRingReserveSkillEquipmentBody);
+}

package/types/maplestory/api/kms/dto/history/starforceHistory.d.ts

@@ -22,7 +22,7 @@ export declare class StarforceHistoryDto {
     /**
      * 스타 캐치
      */
-    starCatchResult: string;
+    starCatchResult: string | null;
     /**
      * 슈페리얼 장비
      */

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

@@ -21,6 +21,8 @@ export * from './dto/character/characterSetEffect';
 export * from './dto/character/characterSkill';
 export * from './dto/character/characterStat';
 export * from './dto/character/characterSymbolEquipment';
+export * from './dto/character/characterRingExchangeSkillEquipment';
+export * from './dto/character/characterRingReserveSkillEquipment';
 export * from './dto/character/characterVMatrix';
 export * from './dto/guild/guild';
 export * from './dto/guild/guildBasic';

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

@@ -16,6 +16,7 @@ import { CharacterPetEquipmentDto } from './dto/character/characterPetEquipment'
 import { CharacterPopularityDto } from './dto/character/characterPopularity';
 import { CharacterPropensityDto } from './dto/character/characterPropensity';
 import { CharacterRingExchangeSkillEquipmentDto } from './dto/character/characterRingExchangeSkillEquipment';
+import { CharacterRingReserveSkillEquipmentDto } from './dto/character/characterRingReserveSkillEquipment';
 import { CharacterSetEffectDto } from './dto/character/characterSetEffect';
 import { CharacterSkillDto } from './dto/character/characterSkill';
 import { CharacterStatDto } from './dto/character/characterStat';
@@ -342,7 +343,8 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
     /**
      * 링 익스체인지 스킬 등록 장비를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
-     * - 2025년 8월 21일 데이터부터 조회할 수 있습니다.
+     * - 2025년 08월 21일부터 2026년 3월 18일까지의 데이터를 조회할 수 있습니다.
+     * - 2026년 3월 19일부터는 예비 특수 반지 장착 정보 조회를 사용해주세요.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (8월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
@@ -351,6 +353,18 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param dateOptions 조회 기준일 (KST)
      */
     getCharacterRingExchangeSkillEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterRingExchangeSkillEquipmentDto | null>;
+    /**
+     * 예비 특수 반지 장착 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
+     * - 2026년 3월 19일 데이터부터 조회할 수 있습니다.
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (3월 20일 데이터 조회 시, 20일 00시부터 21일 00시 사이 데이터가 조회 됩니다.)
+     * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
+     *
+     * @param ocid 캐릭터 식별자
+     * @param dateOptions 조회 기준일 (KST)
+     */
+    getCharacterRingReserveSkillEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterRingReserveSkillEquipmentDto | null>;
     /**
      * 유니온 정보를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.

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

@@ -43,6 +43,7 @@ export type CharacterPetEquipmentItemBody = {
     scroll_upgradable: number;
     item_shape: string | null;
     item_shape_icon: string | null;
+    item_date_expire: string | null;
 };
 export type CharacterPetEquipmentItemOptionBody = {
     option_type: string;

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

@@ -0,0 +1,8 @@
+export type CharacterRingReserveSkillEquipmentBody = {
+    date: string | null;
+    character_class: string;
+    special_ring_reserve_name: string | null;
+    special_ring_reserve_level: number | null;
+    special_ring_reserve_icon: string | null;
+    special_ring_reserve_description: string | null;
+};

package/types/maplestory/api/kms/response/history/starforceHistoryBody.d.ts

@@ -10,7 +10,7 @@ export type StarforceHistoryBody = {
     item_upgrade_result: string;
     before_starforce_count: number;
     after_starforce_count: number;
-    starcatch_result: string;
+    starcatch_result: string | null;
     superior_item_flag: string;
     destroy_defence: string;
     chance_time: string;