maplestory-openapi 3.4.0 → 3.5.0

package/types/maplestory/api/tms/dto/character/characterVMatrix.d.ts

@@ -11,7 +11,7 @@ export declare class CharacterVMatrixDto extends base.CharacterVMatrixDto {
     /**
      * 角色職業
      */
-    characterClass: string | null;
+    characterClass: string;
     /**
      * V 核心資訊
      */
@@ -19,7 +19,7 @@ export declare class CharacterVMatrixDto extends base.CharacterVMatrixDto {
     /**
      * 角色剩餘的矩陣強化點數
      */
-    characterVMatrixRemainSlotUpgradePoint: number | null;
+    characterVMatrixRemainSlotUpgradePoint: number;
     constructor(obj: CharacterVMatrixBody);
 }
 /**

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

@@ -108,7 +108,7 @@ export declare class UnionRaiderBlockDto extends base.UnionRaiderBlockDto {
     /**
      * 方塊角色職業
      */
-    blockClass: string;
+    blockClass: string | null;
     /**
      * 方塊角色等級
      */

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

@@ -55,7 +55,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 角色辨識器
      * @param dateOptions 要搜尋的日期 (TST)
      */
-    getCharacterBasic(ocid: string, dateOptions?: DateOptions): Promise<CharacterBasicDto>;
+    getCharacterBasic(ocid: string, dateOptions?: DateOptions): Promise<CharacterBasicDto | null>;
     /**
      * 檢視角色外型圖片資訊。
      * - 楓之谷遊戲資料平均在 15 分鐘後即可使用。
@@ -67,7 +67,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param imageOptions 圖像選項
      * @param dateOptions 要搜尋的日期 (TST)
      */
-    getCharacterImage(ocid: string, imageOptions?: CharacterImageOptions, dateOptions?: DateOptions): Promise<CharacterImageDto>;
+    getCharacterImage(ocid: string, imageOptions?: CharacterImageOptions, dateOptions?: DateOptions): Promise<CharacterImageDto | null>;
     /**
      * 檢視名聲資訊。
      * - 楓之谷遊戲資料平均在 15 分鐘後即可使用。
@@ -78,7 +78,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 角色辨識器
      * @param dateOptions 要搜尋的日期 (TST)
      */
-    getCharacterPopularity(ocid: string, dateOptions?: DateOptions): Promise<CharacterPopularityDto>;
+    getCharacterPopularity(ocid: string, dateOptions?: DateOptions): Promise<CharacterPopularityDto | null>;
     /**
      * 檢視綜合能力值資訊。
      * - 楓之谷遊戲資料平均在 15 分鐘後即可使用。
@@ -89,7 +89,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 角色辨識器
      * @param dateOptions 要搜尋的日期 (TST)
      */
-    getCharacterStat(ocid: string, dateOptions?: DateOptions): Promise<CharacterStatDto>;
+    getCharacterStat(ocid: string, dateOptions?: DateOptions): Promise<CharacterStatDto | null>;
     /**
      * 檢視極限屬性資訊。
      * - 楓之谷遊戲資料平均在 15 分鐘後即可使用。
@@ -100,7 +100,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 角色辨識器
      * @param dateOptions 要搜尋的日期 (TST)
      */
-    getCharacterHyperStat(ocid: string, dateOptions?: DateOptions): Promise<CharacterHyperStatDto>;
+    getCharacterHyperStat(ocid: string, dateOptions?: DateOptions): Promise<CharacterHyperStatDto | null>;
     /**
      * 檢視性向資訊。
      * - 楓之谷遊戲資料平均在 15 分鐘後即可使用。
@@ -111,7 +111,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 角色辨識器
      * @param dateOptions 要搜尋的日期 (TST)
      */
-    getCharacterPropensity(ocid: string, dateOptions?: DateOptions): Promise<CharacterPropensityDto>;
+    getCharacterPropensity(ocid: string, dateOptions?: DateOptions): Promise<CharacterPropensityDto | null>;
     /**
      * 檢視能力資訊。
      * - 楓之谷遊戲資料平均在 15 分鐘後即可使用。
@@ -122,7 +122,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 角色辨識器
      * @param dateOptions 要搜尋的日期 (TST)
      */
-    getCharacterAbility(ocid: string, dateOptions?: DateOptions): Promise<CharacterAbilityDto>;
+    getCharacterAbility(ocid: string, dateOptions?: DateOptions): Promise<CharacterAbilityDto | null>;
     /**
      * 檢視已裝備道具資訊 (不含現金道具)。
      * - 楓之谷遊戲資料平均在 15 分鐘後即可使用。
@@ -133,7 +133,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 角色辨識器
      * @param dateOptions 要搜尋的日期 (TST)
      */
-    getCharacterItemEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterItemEquipmentDto>;
+    getCharacterItemEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterItemEquipmentDto | null>;
     /**
      * 檢視已裝備現金道具資訊。
      * - 楓之谷遊戲資料平均在 15 分鐘後即可使用。
@@ -144,7 +144,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 角色辨識器
      * @param dateOptions 要搜尋的日期 (TST)
      */
-    getCharacterCashItemEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterCashItemEquipmentDto>;
+    getCharacterCashItemEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterCashItemEquipmentDto | null>;
     /**
      * 檢視已裝備符文資訊。
      * - 楓之谷遊戲資料平均在 15 分鐘後即可使用。
@@ -155,7 +155,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 角色辨識器
      * @param dateOptions 要搜尋的日期 (TST)
      */
-    getCharacterSymbolEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterSymbolEquipmentDto>;
+    getCharacterSymbolEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterSymbolEquipmentDto | null>;
     /**
      * 檢視目前套用的套裝效果資訊。
      * - 楓之谷遊戲資料平均在 15 分鐘後即可使用。
@@ -166,7 +166,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 角色辨識器
      * @param dateOptions 要搜尋的日期 (TST)
      */
-    getCharacterSetEffect(ocid: string, dateOptions?: DateOptions): Promise<CharacterSetEffectDto>;
+    getCharacterSetEffect(ocid: string, dateOptions?: DateOptions): Promise<CharacterSetEffectDto | null>;
     /**
      * 檢視目前已裝備的髮型、臉型與膚色資訊。
      * - 楓之谷遊戲資料平均在 15 分鐘後即可使用。
@@ -177,7 +177,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 角色辨識器
      * @param dateOptions 要搜尋的日期 (TST)
      */
-    getCharacterBeautyEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterBeautyEquipmentDto>;
+    getCharacterBeautyEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterBeautyEquipmentDto | null>;
     /**
      * 檢視已裝備機器人資訊。
      * - 楓之谷遊戲資料平均在 15 分鐘後即可使用。
@@ -188,7 +188,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 角色辨識器
      * @param dateOptions 要搜尋的日期 (TST)
      */
-    getCharacterAndroidEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterAndroidEquipmentDto>;
+    getCharacterAndroidEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterAndroidEquipmentDto | null>;
     /**
      * 檢視已裝備寵物、寵物技能與寵物道具資訊。
      * - 楓之谷遊戲資料平均在 15 分鐘後即可使用。
@@ -199,7 +199,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 角色辨識器
      * @param dateOptions 要搜尋的日期 (TST)
      */
-    getCharacterPetEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterPetEquipmentDto>;
+    getCharacterPetEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterPetEquipmentDto | null>;
     /**
      * 檢視角色技能與超技能資訊。
      * - 楓之谷遊戲資料平均在 15 分鐘後即可使用。
@@ -211,7 +211,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param characterSkillGrade 您要檢視的轉職階段 <a href="https://openapi.nexon.com/game/maplestorytw/?id=49">Available values</a>
      *  @param dateOptions 要搜尋的日期 (TST)
      */
-    getCharacterSkill(ocid: string, characterSkillGrade: string, dateOptions?: DateOptions): Promise<CharacterSkillDto>;
+    getCharacterSkill(ocid: string, characterSkillGrade: string, dateOptions?: DateOptions): Promise<CharacterSkillDto | null>;
     /**
      * 檢視已裝備連結技能資訊。
      * - 楓之谷遊戲資料平均在 15 分鐘後即可使用。
@@ -222,7 +222,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 角色辨識器
      * @param dateOptions 要搜尋的日期 (TST)
      */
-    getCharacterLinkSkill(ocid: string, dateOptions?: DateOptions): Promise<CharacterLinkSkillDto>;
+    getCharacterLinkSkill(ocid: string, dateOptions?: DateOptions): Promise<CharacterLinkSkillDto | null>;
     /**
      * 檢視 V 矩陣欄位資訊與已裝備 V 核心資訊。
      * - 楓之谷遊戲資料平均在 15 分鐘後即可使用。
@@ -233,7 +233,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 角色辨識器
      * @param dateOptions 要搜尋的日期 (TST)
      */
-    getCharacterVMatrix(ocid: string, dateOptions?: DateOptions): Promise<CharacterVMatrixDto>;
+    getCharacterVMatrix(ocid: string, dateOptions?: DateOptions): Promise<CharacterVMatrixDto | null>;
     /**
      * 檢視已裝備於 HEXA 矩陣的 HEXA 核心資訊。
      * - 楓之谷遊戲資料平均在 15 分鐘後即可使用。
@@ -244,7 +244,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 角色辨識器
      * @param dateOptions 要搜尋的日期 (TST)
      */
-    getCharacterHexaMatrix(ocid: string, dateOptions?: DateOptions): Promise<CharacterHexaMatrixDto>;
+    getCharacterHexaMatrix(ocid: string, dateOptions?: DateOptions): Promise<CharacterHexaMatrixDto | null>;
     /**
      * 檢視設定於 HEXA 矩陣中的 HEXA 屬性資訊。
      * - 楓之谷遊戲資料平均在 15 分鐘後即可使用。
@@ -255,7 +255,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 角色辨識器
      * @param dateOptions 要搜尋的日期 (TST)
      */
-    getCharacterHexaMatrixStat(ocid: string, dateOptions?: DateOptions): Promise<CharacterHexaMatrixStatDto>;
+    getCharacterHexaMatrixStat(ocid: string, dateOptions?: DateOptions): Promise<CharacterHexaMatrixStatDto | null>;
     /**
      * 檢視角色在武陵道場的最高紀錄資訊。
      * - 楓之谷遊戲資料平均在 15 分鐘後即可使用。
@@ -266,7 +266,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 角色辨識器
      * @param dateOptions 要搜尋的日期 (TST)
      */
-    getCharacterDojang(ocid: string, dateOptions?: DateOptions): Promise<CharacterDojangDto>;
+    getCharacterDojang(ocid: string, dateOptions?: DateOptions): Promise<CharacterDojangDto | null>;
     /**
      * 檢視戰地等級與戰地階級資訊。
      * - 楓之谷遊戲資料平均在 15 分鐘後即可使用。
@@ -277,7 +277,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 角色辨識器
      * @param dateOptions 要搜尋的日期 (TST)
      */
-    getUnion(ocid: string, dateOptions?: DateOptions): Promise<UnionDto>;
+    getUnion(ocid: string, dateOptions?: DateOptions): Promise<UnionDto | null>;
     /**
      * 檢視詳細資訊，例如派遣至聯盟的攻擊單位成員效果，以及攻擊單位佔領效果。
      * - 楓之谷遊戲資料平均在 15 分鐘後即可使用。
@@ -288,7 +288,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 角色辨識器
      * @param dateOptions 要搜尋的日期 (TST)
      */
-    getUnionRaider(ocid: string, dateOptions?: DateOptions): Promise<UnionRaiderDto>;
+    getUnionRaider(ocid: string, dateOptions?: DateOptions): Promise<UnionRaiderDto | null>;
     /**
      * 檢視戰地神器資訊。
      * - 楓之谷遊戲資料平均在 15 分鐘後即可使用。
@@ -299,7 +299,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 角色辨識器
      * @param dateOptions 要搜尋的日期 (TST)
      */
-    getUnionArtifact(ocid: string, dateOptions?: DateOptions): Promise<UnionArtifactDto>;
+    getUnionArtifact(ocid: string, dateOptions?: DateOptions): Promise<UnionArtifactDto | null>;
     /**
      * 檢視公會識別碼 (oguild_id) 資訊。
      * - 楓之谷遊戲資料平均在 15 分鐘後即可使用。
@@ -310,7 +310,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param guildName 公會名稱
      * @param worldName 世界名稱 <a href="https://openapi.nexon.com/game/maplestorytw/?id=51">Available values</a>
      */
-    getGuild(guildName: string, worldName: string): Promise<GuildDto>;
+    getGuild(guildName: string, worldName: string): Promise<GuildDto | null>;
     /**
      * 檢視公會基本資訊。
      * - 楓之谷遊戲資料平均在 15 分鐘後即可使用。
@@ -321,7 +321,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param guildId 公會識別碼
      * @param dateOptions 要搜尋的日期 (TST)
      */
-    getGuildBasic(guildId: string, dateOptions?: DateOptions): Promise<GuildBasicDto>;
+    getGuildBasic(guildId: string, dateOptions?: DateOptions): Promise<GuildBasicDto | null>;
 }
 type CharacterImageOptions = {
     /**

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

@@ -10,7 +10,7 @@ export type CharacterBasicBody = {
     character_exp_rate: string;
     character_guild_name: string | null;
     character_image: string;
-    character_date_create: string;
+    character_date_create: string | null;
     access_flag: 'true' | 'false';
     liberation_quest_clear: string;
 };

package/types/maplestory/api/tms/response/character/characterPopularityBody.d.ts

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

package/types/maplestory/api/tms/response/union/unionRaiderBody.d.ts

@@ -17,7 +17,7 @@ export type UnionRaiderInnerStatBody = {
 };
 export type UnionRaiderBlockBody = {
     block_type: string;
-    block_class: string;
+    block_class: string | null;
     block_level: string;
     block_control_point: UnionRaiderBlockControlPointBody;
     block_position: UnionRaiderBlockPositionBody[];