maplestory-openapi 3.0.0 → 3.2.0

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

@@ -98,7 +98,15 @@ export declare class CharacterAndroidEquipmentFaceDto extends base.CharacterAndr
      * 안드로이드 성형 믹스 컬러의 염색 비율
      */
     mixRate: string;
+    /**
+     * 프리스타일 쿠폰 적용 여부 (0:미적용, 1:적용)
+     */
+    freestyleFlag: string | null;
     constructor(obj: CharacterAndroidEquipmentFaceBody);
+    /**
+     * 프리스타일 쿠폰 적용 여부
+     */
+    get isFreestyleFlag(): boolean;
 }
 /**
  * 캐릭터 안드로이드 헤어 정보
@@ -120,7 +128,15 @@ export declare class CharacterAndroidEquipmentHairDto extends base.CharacterAndr
      * 안드로이드 헤어 믹스 컬러의 염색 비율
      */
     mixRate: string;
+    /**
+     * 프리스타일 쿠폰 적용 여부 (0:미적용, 1:적용)
+     */
+    freestyleFlag: string | null;
     constructor(obj: CharacterAndroidEquipmentHairBody);
+    /**
+     * 프리스타일 쿠폰 적용 여부
+     */
+    get isFreestyleFlag(): boolean;
 }
 /**
  * 캐릭터 안드로이드 피부 정보
@@ -290,5 +306,17 @@ export declare class CharacterAndroidCashItemEquipmentDto extends base.Character
      * 안드로이드 캐시 아이템 컬러링프리즘 정보
      */
     cashItemColoringPrism: CharacterAndroidCashItemEquipmentColoringPrismDto | null;
+    /**
+     * 아이템 장착 가능 성별
+     */
+    androidItemGender: string | null;
+    /**
+     * 프리스타일 쿠폰 적용 여부 (0:미적용, 1:적용)
+     */
+    freestyleFlag: string | null;
     constructor(obj: CharacterAndroidCashItemEquipmentBody);
+    /**
+     * 프리스타일 쿠폰 적용 여부
+     */
+    get isFreestyleFlag(): boolean;
 }

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

@@ -57,16 +57,12 @@ export declare class CharacterBasicDto extends base.CharacterBasicDto {
      */
     accessFlag: 'true' | 'false';
     /**
-     * 해방 퀘스트 완료 여부
+     * 해방 퀘스트 완료 여부 (0:미완료, 1:제네시스 무기 해방, 2:데스티니 무기 1차 해방)
      */
-    liberationQuestClearFlag: 'true' | 'false';
+    liberationQuestClear: string;
     constructor(obj: CharacterBasicBody);
     /**
      * 최근 7일간 접속 여부
      */
     get isAccessFlag(): boolean;
-    /**
-     * 해방 퀘스트 완료 여부
-     */
-    get isLiberationQuestClearFlag(): boolean;
 }

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

@@ -65,7 +65,15 @@ export declare class CharacterBeautyEquipmentFaceDto extends base.CharacterBeaut
      * 성형 믹스 컬러의 염색 비율
      */
     mixRate: string;
+    /**
+     * 프리스타일 쿠폰 적용 여부 (0:미적용, 1:적용)
+     */
+    freestyleFlag: string | null;
     constructor(obj: CharacterBeautyEquipmentFaceBody);
+    /**
+     * 프리스타일 쿠폰 적용 여부
+     */
+    get isFreestyleFlag(): boolean;
 }
 /**
  * 캐릭터 헤어 정보
@@ -87,7 +95,15 @@ export declare class CharacterBeautyEquipmentHairDto extends base.CharacterBeaut
      * 헤어 믹스 컬러의 염색 비율
      */
     mixRate: string;
+    /**
+     * 프리스타일 쿠폰 적용 여부 (0:미적용, 1:적용)
+     */
+    freestyleFlag: string | null;
     constructor(obj: CharacterBeautyEquipmentHairBody);
+    /**
+     * 프리스타일 쿠폰 적용 여부
+     */
+    get isFreestyleFlag(): boolean;
 }
 /**
  * 캐릭터 피부 정보

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

@@ -154,5 +154,13 @@ export declare class CharacterCashItemEquipmentPresetDto extends base.CharacterC
      * 스킬명
      */
     skills: string[];
+    /**
+     * 프리스타일 쿠폰 적용 여부 (0:미적용, 1:적용)
+     */
+    freestyleFlag: string | null;
     constructor(obj: CharacterCashItemEquipmentPresetBody);
+    /**
+     * 프리스타일 쿠폰 적용 여부
+     */
+    get isFreestyleFlag(): boolean;
 }

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

@@ -610,7 +610,15 @@ export declare class CharacterItemEquipmentDragonInfoDto extends base.CharacterI
      * 장비 유효 기간 만료 여부
      */
     isExpired: boolean | null;
+    /**
+     * 프리스타일 쿠폰 적용 여부 (0:미적용, 1:적용)
+     */
+    freestyleFlag: string | null;
     constructor(obj: CharacterItemEquipmentDragonInfoBody);
+    /**
+     * 프리스타일 쿠폰 적용 여부
+     */
+    get isFreestyleFlag(): boolean;
 }
 /**
  * 메카닉 장비 정보
@@ -732,7 +740,15 @@ export declare class CharacterItemEquipmentMechanicInfoDto extends base.Characte
      * 장비 유효 기간 만료 여부
      */
     isExpired: boolean | null;
+    /**
+     * 프리스타일 쿠폰 적용 여부 (0:미적용, 1:적용)
+     */
+    freestyleFlag: string | null;
     constructor(obj: CharacterItemEquipmentMechanicInfoBody);
+    /**
+     * 프리스타일 쿠폰 적용 여부
+     */
+    get isFreestyleFlag(): boolean;
 }
 /**
  * 캐릭터 장비 아이템 상세 정보
@@ -886,5 +902,13 @@ export declare class CharacterItemEquipmentInfoDto extends base.CharacterItemEqu
      * 장비 유효 기간 만료 여부
      */
     isExpired: boolean | null;
+    /**
+     * 프리스타일 쿠폰 적용 여부 (0:미적용, 1:적용)
+     */
+    freestyleFlag: string | null;
     constructor(obj: CharacterItemEquipmentInfoBody);
+    /**
+     * 프리스타일 쿠폰 적용 여부
+     */
+    get isFreestyleFlag(): boolean;
 }

package/types/maplestory/api/kms/dto/user/achievement.d.ts

@@ -0,0 +1,39 @@
+import { AchievementAccountListBody, AchievementAchieveBody, AchievementBody } from '../../response/user/achievementBody';
+/**
+ * 계정의 업적 목록
+ */
+export declare class AchievementDto {
+    /**
+     * 메이플스토리 계정 목록
+     */
+    accountList: AchievementAccountListDto[];
+    constructor(obj: AchievementBody);
+}
+/**
+ * 메이플스토리 계정
+ */
+export declare class AchievementAccountListDto {
+    /**
+     * 메이플스토리 계정 식별자
+     */
+    accountId: string;
+    /**
+     * 달성 업적 정보
+     */
+    achievementAchieve: AchievementAchieveDto[];
+    constructor(obj: AchievementAccountListBody);
+}
+/**
+ * 달성 업적 정보
+ */
+export declare class AchievementAchieveDto {
+    /**
+     * 업적 명
+     */
+    achievementName: string;
+    /**
+     * 업적 설명
+     */
+    achievementDescription: string;
+    constructor(obj: AchievementAchieveBody);
+}

package/types/maplestory/api/kms/dto/{character → user}/characterList.d.ts

@@ -1,9 +1,8 @@
-import * as base from '../../../common/dto/character/characterList';
-import { CharacterListAccountBody, CharacterListAccountCharacterBody, CharacterListBody } from '../../response/character/characterListBody';
+import { CharacterListAccountBody, CharacterListAccountCharacterBody, CharacterListBody } from '../../response/user/characterListBody';
 /**
  * 계정의 보유 캐릭터 목록
  */
-export declare class CharacterListDto extends base.CharacterListDto {
+export declare class CharacterListDto {
     /**
      * 메이플스토리 계정 목록
      */
@@ -13,7 +12,7 @@ export declare class CharacterListDto extends base.CharacterListDto {
 /**
  * 캐릭터 정보
  */
-export declare class CharacterListAccountCharacterDto extends base.CharacterListAccountCharacterDto {
+export declare class CharacterListAccountCharacterDto {
     /**
      * 캐릭터 식별자
      */
@@ -39,7 +38,7 @@ export declare class CharacterListAccountCharacterDto extends base.CharacterList
 /**
  * 메이플스토리 계정
  */
-export declare class CharacterListAccountDto extends base.CharacterListAccountDto {
+export declare class CharacterListAccountDto {
     /**
      * 메이플스토리 계정 식별자
      */

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

@@ -12,7 +12,6 @@ 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';
@@ -44,4 +43,6 @@ export * from './dto/union/union';
 export * from './dto/union/unionArtifact';
 export * from './dto/union/unionChampion';
 export * from './dto/union/unionRaider';
+export * from './dto/user/achievement';
+export * from './dto/user/characterList';
 export * from './dto/inspectionInfo';

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

@@ -11,7 +11,6 @@ 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';
@@ -44,6 +43,8 @@ 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 { AchievementDto } from './dto/user/achievement';
+import { CharacterListDto } from './dto/user/characterList';
 import { CharacterImageAction, CharacterImageEmotion, CharacterImageWeaponMotion } from '../common/enum/characterImage';
 import { DateOptions } from '../common/mapleStoryApi';
 import * as base from '../common/mapleStoryApi';
@@ -56,24 +57,32 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
     protected timezoneOffset: number;
     constructor(apiKey: string);
     /**
-     * 캐릭터 식별자(ocid)를 조회합니다.
+     * 계정의 보유 캐릭터 목록을 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
-     * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
-     *
-     * @param characterName    캐릭터 명
      */
-    getCharacter(characterName: string): Promise<CharacterDto>;
+    getCharacterList(): Promise<CharacterListDto>;
     /**
-     * 계정의 보유 캐릭터 목록을 조회합니다.
+     * 계정의 업적 정보를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      */
-    getCharacterList(): Promise<CharacterListDto>;
+    getAchievement(): Promise<AchievementDto>;
+    /**
+     * 캐릭터 식별자(ocid)를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
+     * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
+     * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
+     *
+     * @param characterName    캐릭터 명
+     */
+    getCharacter(characterName: string): Promise<CharacterDto>;
     /**
      * 기본 정보를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.

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

@@ -23,12 +23,14 @@ export type CharacterAndroidEquipmentHairBody = {
     base_color: string | null;
     mix_color: string | null;
     mix_rate: string;
+    freestyle_flag: string | null;
 };
 export type CharacterAndroidEquipmentFaceBody = {
     face_name: string | null;
     base_color: string | null;
     mix_color: string | null;
     mix_rate: string;
+    freestyle_flag: string | null;
 };
 export type CharacterAndroidEquipmentSkinBody = {
     skin_name: string;
@@ -62,6 +64,8 @@ export type CharacterAndroidCashItemEquipmentBody = {
     date_option_expire: string | null;
     cash_item_label: string | null;
     cash_item_coloring_prism: CharacterAndroidCashItemEquipmentColoringPrismBody | null;
+    android_item_gender: string;
+    freestyle_flag: string | null;
 };
 export type CharacterAndroidCashItemEquipmentOptionBody = {
     option_type: string;

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

@@ -12,5 +12,5 @@ export type CharacterBasicBody = {
     character_image: string;
     character_date_create: string;
     access_flag: 'true' | 'false';
-    liberation_quest_clear_flag: 'true' | 'false';
+    liberation_quest_clear: string;
 };

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

@@ -14,12 +14,14 @@ export type CharacterBeautyEquipmentHairBody = {
     base_color: string;
     mix_color: string | null;
     mix_rate: string;
+    freestyle_flag: string | null;
 };
 export type CharacterBeautyEquipmentFaceBody = {
     face_name: string;
     base_color: string;
     mix_color: string | null;
     mix_rate: string;
+    freestyle_flag: string | null;
 };
 export type CharacterBeautyEquipmentSkinBody = {
     skin_name: string;

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

@@ -26,6 +26,7 @@ export type CharacterCashItemEquipmentPresetBody = {
     cash_item_coloring_prism: CharacterCashItemEquipmentColoringPrismBody | null;
     item_gender: string | null;
     skills: string[];
+    freestyle_flag: string | null;
 };
 export type CharacterCashItemEquipmentOptionBody = {
     option_type: string;

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

@@ -49,6 +49,7 @@ export type CharacterItemEquipmentInfoBody = {
     item_starforce_option: CharacterItemEquipmentStarforceOptionBody;
     special_ring_level: number;
     date_expire: string | null;
+    freestyle_flag: string | null;
 };
 export type CharacterItemEquipmentMechanicInfoBody = {
     item_equipment_part: string;
@@ -79,6 +80,7 @@ export type CharacterItemEquipmentMechanicInfoBody = {
     item_starforce_option: CharacterItemEquipmentOptionBody;
     special_ring_level: number;
     date_expire: string | null;
+    freestyle_flag: string | null;
 };
 export type CharacterItemEquipmentDragonInfoBody = CharacterItemEquipmentMechanicInfoBody;
 export type CharacterItemEquipmentOptionBody = {

package/types/maplestory/api/kms/response/user/achievementBody.d.ts

@@ -0,0 +1,11 @@
+export type AchievementBody = {
+    account_list: AchievementAccountListBody[];
+};
+export type AchievementAccountListBody = {
+    account_id: string;
+    achievement_achieve: AchievementAchieveBody[];
+};
+export type AchievementAchieveBody = {
+    achievement_name: string;
+    achievement_description: string;
+};

package/types/maplestory/api/msea/dto/character/characterAndroidEquipment.d.ts

@@ -291,5 +291,9 @@ export declare class CharacterAndroidCashItemEquipmentDto extends base.Character
      * Android cash item coloring prism information
      */
     cashItemColoringPrism: CharacterAndroidCashItemEquipmentColoringPrismDto | null;
+    /**
+     * Gender compatibility for item equipment
+     */
+    androidItemGender: string | null;
     constructor(obj: CharacterAndroidCashItemEquipmentBody);
 }

package/types/maplestory/api/msea/response/character/characterAndroidEquipmentBody.d.ts

@@ -62,6 +62,7 @@ export type CharacterAndroidCashItemEquipmentBody = {
     date_option_expire: string | null;
     cash_item_label: string | null;
     cash_item_coloring_prism: CharacterAndroidCashItemEquipmentColoringPrismBody | null;
+    android_item_gender: string | null;
 };
 export type CharacterAndroidCashItemEquipmentOptionBody = {
     option_type: string;

package/dist/cjs/maplestory/api/common/dto/character/characterList.js

@@ -1,14 +0,0 @@
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-class CharacterListDto {
-}
-class CharacterListAccountCharacterDto {
-}
-class CharacterListAccountDto {
-}
-
-exports.CharacterListAccountCharacterDto = CharacterListAccountCharacterDto;
-exports.CharacterListAccountDto = CharacterListAccountDto;
-exports.CharacterListDto = CharacterListDto;

package/dist/esm/maplestory/api/common/dto/character/characterList.js

@@ -1,8 +0,0 @@
-class CharacterListDto {
-}
-class CharacterListAccountCharacterDto {
-}
-class CharacterListAccountDto {
-}
-
-export { CharacterListAccountCharacterDto, CharacterListAccountDto, CharacterListDto };

package/types/maplestory/api/common/dto/character/characterList.d.ts

@@ -1,14 +0,0 @@
-export declare abstract class CharacterListDto {
-    abstract accountList: CharacterListAccountDto[];
-}
-export declare abstract class CharacterListAccountCharacterDto {
-    abstract ocid: string;
-    abstract characterName: string;
-    abstract worldName: string;
-    abstract characterClass: string;
-    abstract characterLevel: number;
-}
-export declare abstract class CharacterListAccountDto {
-    abstract accountId: string;
-    abstract characterList: CharacterListAccountCharacterDto[];
-}