maplestory-openapi 2.10.0 → 2.11.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.mjs CHANGED
@@ -2551,7 +2551,11 @@ class CharacterAndroidCashItemEquipmentDto {
2551
2551
  /**
2552
2552
  * 안드로이드 캐시 아이템 옵션 유효 기간 (KST, 시간 단위 데이터로 분은 일괄 0으로 표기)
2553
2553
  */
2554
- dateOptionExpire;
2554
+ dateOptionExpire = null;
2555
+ /**
2556
+ * 안드로이드 캐시 아이템 옵션 유효 기간 만료 여부
2557
+ */
2558
+ isOptionExpired = null;
2555
2559
  /**
2556
2560
  * 안드로이드 캐시 아이템 라벨 정보 (스페셜라벨, 레드라벨, 블랙라벨, 마스터라벨)
2557
2561
  */
@@ -2569,13 +2573,18 @@ class CharacterAndroidCashItemEquipmentDto {
2569
2573
  this.cashItemDescription = cash_item_description;
2570
2574
  this.cashItemOption = cash_item_option.map((option) => new CharacterAndroidCashItemEquipmentOptionDto(option));
2571
2575
  this.dateExpire = date_expire ? new Date(date_expire) : null;
2572
- this.dateOptionExpire = date_option_expire
2573
- ? new Date(date_option_expire)
2574
- : null;
2575
2576
  this.cashItemLabel = cash_item_label;
2576
2577
  this.cashItemColoringPrism = cash_item_coloring_prism
2577
2578
  ? new CharacterAndroidCashItemEquipmentColoringPrismDto(cash_item_coloring_prism)
2578
2579
  : null;
2580
+ if (date_option_expire === 'expired') {
2581
+ this.isOptionExpired = true;
2582
+ }
2583
+ else if (typeof date_option_expire === 'string') {
2584
+ this.dateOptionExpire = date_option_expire
2585
+ ? new Date(date_option_expire)
2586
+ : null;
2587
+ }
2579
2588
  }
2580
2589
  }
2581
2590
 
@@ -3165,7 +3174,11 @@ class CharacterCashItemEquipmentPresetDto {
3165
3174
  /**
3166
3175
  * 캐시 장비 옵션 유효 기간 (KST, 시간 단위 데이터로 분은 일괄 0으로 표기)
3167
3176
  */
3168
- dateOptionExpire;
3177
+ dateOptionExpire = null;
3178
+ /**
3179
+ * 캐시 장비 옵션 유효 기간 만료 여부
3180
+ */
3181
+ isOptionExpired = null;
3169
3182
  /**
3170
3183
  * 캐시 장비 라벨 정보
3171
3184
  */
@@ -3178,21 +3191,33 @@ class CharacterCashItemEquipmentPresetDto {
3178
3191
  * 아이템 장착 가능 성별
3179
3192
  */
3180
3193
  itemGender;
3194
+ /**
3195
+ * 스킬명
3196
+ */
3197
+ skills;
3181
3198
  constructor(obj) {
3182
- const { cash_item_equipment_part, cash_item_equipment_slot, cash_item_name, cash_item_icon, cash_item_description, cash_item_option, date_expire, date_option_expire, cash_item_label, cash_item_coloring_prism, item_gender, } = obj;
3199
+ const { cash_item_equipment_part, cash_item_equipment_slot, cash_item_name, cash_item_icon, cash_item_description, cash_item_option, date_expire, date_option_expire, cash_item_label, cash_item_coloring_prism, item_gender, skills, } = obj;
3183
3200
  this.cashItemEquipmentPart = cash_item_equipment_part;
3184
3201
  this.cashItemEquipmentSlot = cash_item_equipment_slot;
3185
3202
  this.cashItemName = cash_item_name;
3186
3203
  this.cashItemIcon = cash_item_icon;
3187
3204
  this.cashItemDescription = cash_item_description;
3188
3205
  this.cashItemOption = cash_item_option.map((option) => new CharacterCashItemEquipmentOptionDto(option));
3189
- this.dateExpire = date_expire;
3190
- this.dateOptionExpire = date_option_expire;
3206
+ this.dateExpire = date_expire ? new Date(date_expire) : null;
3191
3207
  this.cashItemLabel = cash_item_label;
3192
3208
  this.cashItemColoringPrism = cash_item_coloring_prism
3193
3209
  ? new CharacterCashItemEquipmentColoringPrismDto(cash_item_coloring_prism)
3194
3210
  : null;
3195
3211
  this.itemGender = item_gender;
3212
+ this.skills = skills;
3213
+ if (date_option_expire === 'expired') {
3214
+ this.isOptionExpired = true;
3215
+ }
3216
+ else if (typeof date_option_expire === 'string') {
3217
+ this.dateOptionExpire = date_option_expire
3218
+ ? new Date(date_option_expire)
3219
+ : null;
3220
+ }
3196
3221
  }
3197
3222
  }
3198
3223
 
@@ -4022,7 +4047,7 @@ class CharacterItemEquipmentExceptionalOptionDto {
4022
4047
  this.maxMp = max_mp;
4023
4048
  this.attackPower = attack_power;
4024
4049
  this.magicPower = magic_power;
4025
- this.exceptionalUpgrade = exceptional_upgrade;
4050
+ this.exceptionalUpgrade = exceptional_upgrade ?? 0;
4026
4051
  }
4027
4052
  }
4028
4053
 
@@ -4676,6 +4701,45 @@ class CharacterItemEquipmentMechanicInfoDto {
4676
4701
  }
4677
4702
  }
4678
4703
 
4704
+ /**
4705
+ * 캐릭터 외형 설정에 등록한 훈장 외형 정보
4706
+ */
4707
+ class CharacterItemEquipmentMedalShapeDto {
4708
+ /**
4709
+ * 외형 설정에 등록한 훈장 장비 명
4710
+ */
4711
+ medalShapeName;
4712
+ /**
4713
+ * 외형 설정에 등록한 훈장 아이콘
4714
+ */
4715
+ medalShapeIcon;
4716
+ /**
4717
+ * 외형 설정에 등록한 훈장 설명
4718
+ */
4719
+ medalShapeDescription;
4720
+ /**
4721
+ * 외형 설정에 등록한 훈장의 모루 적용 장비 명
4722
+ */
4723
+ medalShapeChangedName;
4724
+ /**
4725
+ * 외형 설정에 등록한 훈장의 모루 적용 아이콘
4726
+ */
4727
+ medalShapeChangedIcon;
4728
+ /**
4729
+ * 외형 설정에 등록한 훈장의 모루 적용 훈장 설명
4730
+ */
4731
+ medalShapeChangedDescription;
4732
+ constructor(obj) {
4733
+ const { medal_shape_name, medal_shape_icon, medal_shape_description, medal_shape_changed_name, medal_shape_changed_icon, medal_shape_changed_description, } = obj;
4734
+ this.medalShapeName = medal_shape_name;
4735
+ this.medalShapeIcon = medal_shape_icon;
4736
+ this.medalShapeDescription = medal_shape_description;
4737
+ this.medalShapeChangedName = medal_shape_changed_name;
4738
+ this.medalShapeChangedIcon = medal_shape_changed_icon;
4739
+ this.medalShapeChangedDescription = medal_shape_changed_description;
4740
+ }
4741
+ }
4742
+
4679
4743
  /**
4680
4744
  * 캐릭터 칭호 아이템 정보
4681
4745
  */
@@ -4704,12 +4768,27 @@ class CharacterItemEquipmentTitleDto {
4704
4768
  * 칭호 옵션 유효 기간 만료 여부
4705
4769
  */
4706
4770
  isOptionExpired = null;
4771
+ /**
4772
+ * 외형 설정에 등록한 칭호 장비 명
4773
+ */
4774
+ titleShapeName;
4775
+ /**
4776
+ * 외형 설정에 등록한 칭호 아이콘
4777
+ */
4778
+ titleShapeIcon;
4779
+ /**
4780
+ * 외형 설정에 등록한 칭호 설명
4781
+ */
4782
+ titleShapeDescription;
4707
4783
  constructor(obj) {
4708
- const { title_name, title_icon, title_description, date_expire, date_option_expire, } = obj;
4784
+ const { title_name, title_icon, title_description, date_expire, date_option_expire, title_shape_name, title_shape_icon, title_shape_description, } = obj;
4709
4785
  this.titleName = title_name;
4710
4786
  this.titleIcon = title_icon;
4711
4787
  this.titleDescription = title_description;
4712
4788
  this.dateExpire = date_expire ? new Date(date_expire) : null;
4789
+ this.titleShapeName = title_shape_name;
4790
+ this.titleShapeIcon = title_shape_icon;
4791
+ this.titleShapeDescription = title_shape_description;
4713
4792
  if (date_option_expire === 'expired') {
4714
4793
  this.isOptionExpired = true;
4715
4794
  }
@@ -4761,6 +4840,10 @@ class CharacterItemEquipmentDto {
4761
4840
  * 칭호 정보
4762
4841
  */
4763
4842
  title;
4843
+ /**
4844
+ * 외형 설정에 등록한 훈장 외형 정보
4845
+ */
4846
+ medalShape;
4764
4847
  /**
4765
4848
  * 에반 드래곤 장비 정보 (에반인 경우 응답)
4766
4849
  */
@@ -4770,7 +4853,7 @@ class CharacterItemEquipmentDto {
4770
4853
  */
4771
4854
  mechanicEquipment;
4772
4855
  constructor(obj) {
4773
- const { date, character_gender, character_class, preset_no, item_equipment, item_equipment_preset_1, item_equipment_preset_2, item_equipment_preset_3, title, dragon_equipment, mechanic_equipment, } = obj;
4856
+ const { date, character_gender, character_class, preset_no, item_equipment, item_equipment_preset_1, item_equipment_preset_2, item_equipment_preset_3, title, medal_shape, dragon_equipment, mechanic_equipment, } = obj;
4774
4857
  this.date = date ? new Date(date) : null;
4775
4858
  this.characterGender = character_gender;
4776
4859
  this.characterClass = character_class;
@@ -4780,6 +4863,7 @@ class CharacterItemEquipmentDto {
4780
4863
  this.itemEquipmentPreset2 = item_equipment_preset_2 ? item_equipment_preset_2.map((equipment) => new CharacterItemEquipmentInfoDto(equipment)) : null;
4781
4864
  this.itemEquipmentPreset3 = item_equipment_preset_3 ? item_equipment_preset_3.map((equipment) => new CharacterItemEquipmentInfoDto(equipment)) : null;
4782
4865
  this.title = title ? new CharacterItemEquipmentTitleDto(title) : null;
4866
+ this.medalShape = medal_shape ? new CharacterItemEquipmentMedalShapeDto(medal_shape) : null;
4783
4867
  this.dragonEquipment = dragon_equipment.map((equipment) => new CharacterItemEquipmentDragonInfoDto(equipment));
4784
4868
  this.mechanicEquipment = mechanic_equipment.map((equipment) => new CharacterItemEquipmentMechanicInfoDto(equipment));
4785
4869
  }
@@ -7405,6 +7489,73 @@ const errorMap = {
7405
7489
  ['OPENAPI00011']: MapleStoryApiErrorCode.OPENAPI00011,
7406
7490
  };
7407
7491
 
7492
+ /**
7493
+ * 유니온 챔피언 휘장 정보
7494
+ */
7495
+ class UnionChampionBadgeInfoDto {
7496
+ /**
7497
+ * 유니온 챔피언 휘장 효과
7498
+ */
7499
+ stat;
7500
+ constructor(obj) {
7501
+ const { stat } = obj;
7502
+ this.stat = stat;
7503
+ }
7504
+ }
7505
+
7506
+ /**
7507
+ * 유니온 챔피언 상세 정보
7508
+ */
7509
+ class UnionChampionInfoDto {
7510
+ /**
7511
+ * 유니온 챔피언 슬롯
7512
+ */
7513
+ championSlot;
7514
+ /**
7515
+ * 유니온 챔피언 등급
7516
+ */
7517
+ championGrade;
7518
+ /**
7519
+ * 유니온 챔피언 캐릭터의 직업
7520
+ */
7521
+ championClass;
7522
+ /**
7523
+ * 챔피언 휘장 효과
7524
+ */
7525
+ championBadgeInfo;
7526
+ constructor(obj) {
7527
+ const { champion_slot, champion_grade, champion_class, champion_badge_info } = obj;
7528
+ this.championSlot = champion_slot;
7529
+ this.championGrade = champion_grade;
7530
+ this.championClass = champion_class;
7531
+ this.championBadgeInfo = champion_badge_info.map((info) => new UnionChampionBadgeInfoDto(info));
7532
+ }
7533
+ }
7534
+
7535
+ /**
7536
+ * 유니온 챔피언 정보
7537
+ */
7538
+ class UnionChampionDto {
7539
+ /**
7540
+ * 조회 기준일
7541
+ */
7542
+ date;
7543
+ /**
7544
+ * 유니온 챔피언 정보
7545
+ */
7546
+ unionChampion;
7547
+ /**
7548
+ * 유니온 챔피언 휘장 정보
7549
+ */
7550
+ championBadgeTotalInfo;
7551
+ constructor(obj) {
7552
+ const { date, union_champion, champion_badge_total_info } = obj;
7553
+ this.date = date ? new Date(date) : null;
7554
+ this.unionChampion = union_champion.map((info) => new UnionChampionInfoDto(info));
7555
+ this.championBadgeTotalInfo = champion_badge_total_info.map((info) => new UnionChampionBadgeInfoDto(info));
7556
+ }
7557
+ }
7558
+
7408
7559
  dayjs.extend(timezone);
7409
7560
  dayjs.extend(utc);
7410
7561
  /**
@@ -8158,6 +8309,35 @@ class MapleStoryApi {
8158
8309
  });
8159
8310
  return new UnionArtifactDto(data);
8160
8311
  }
8312
+ /**
8313
+ * 유니온 챔피언 정보를 조회합니다.<br>
8314
+ * 유니온 챔피언 정보는 2025년 2월 20일 메이플스토리 점검 이후 데이터부터 조회 가능합니다.<br>
8315
+ * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
8316
+ * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
8317
+ * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
8318
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
8319
+ *
8320
+ * @param ocid 캐릭터 식별자
8321
+ * @param dateOptions 조회 기준일 (KST)
8322
+ */
8323
+ async getUnionChampion(ocid, dateOptions) {
8324
+ const path = 'maplestory/v1/user/union-champion';
8325
+ const date = dateOptions
8326
+ ? MapleStoryApi.toDateString({
8327
+ year: 2023,
8328
+ month: 12,
8329
+ day: 21,
8330
+ }, dateOptions)
8331
+ : undefined;
8332
+ const query = {
8333
+ ocid: ocid,
8334
+ date: date,
8335
+ };
8336
+ const { data } = await this.client.get(path, {
8337
+ params: query,
8338
+ });
8339
+ return new UnionChampionDto(data);
8340
+ }
8161
8341
  //#endregion
8162
8342
  //#region 길드 정보 조회
8163
8343
  /**
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "maplestory-openapi",
3
- "version": "2.10.0",
3
+ "version": "2.11.1",
4
4
  "description": "This JavaScript library enables the use of the MapleStory OpenAPI of Nexon.",
5
5
  "keywords": [
6
6
  "maplestory",
@@ -37,6 +37,10 @@ declare class CharacterAndroidCashItemEquipmentDto {
37
37
  * 안드로이드 캐시 아이템 옵션 유효 기간 (KST, 시간 단위 데이터로 분은 일괄 0으로 표기)
38
38
  */
39
39
  dateOptionExpire: Date | null;
40
+ /**
41
+ * 안드로이드 캐시 아이템 옵션 유효 기간 만료 여부
42
+ */
43
+ isOptionExpired: boolean | null;
40
44
  /**
41
45
  * 안드로이드 캐시 아이템 라벨 정보 (스페셜라벨, 레드라벨, 블랙라벨, 마스터라벨)
42
46
  */
@@ -32,11 +32,15 @@ declare class CharacterCashItemEquipmentPresetDto {
32
32
  /**
33
33
  * 캐시 장비 유효 기간 (KST)
34
34
  */
35
- dateExpire: string | null;
35
+ dateExpire: Date | null;
36
36
  /**
37
37
  * 캐시 장비 옵션 유효 기간 (KST, 시간 단위 데이터로 분은 일괄 0으로 표기)
38
38
  */
39
- dateOptionExpire: string | null;
39
+ dateOptionExpire: Date | null;
40
+ /**
41
+ * 캐시 장비 옵션 유효 기간 만료 여부
42
+ */
43
+ isOptionExpired: boolean | null;
40
44
  /**
41
45
  * 캐시 장비 라벨 정보
42
46
  */
@@ -49,6 +53,10 @@ declare class CharacterCashItemEquipmentPresetDto {
49
53
  * 아이템 장착 가능 성별
50
54
  */
51
55
  itemGender: string | null;
56
+ /**
57
+ * 스킬명
58
+ */
59
+ skills: string[];
52
60
  constructor(obj: CharacterCashItemEquipmentPresetDtoBody);
53
61
  }
54
62
  export { CharacterCashItemEquipmentPresetDto };
@@ -1,6 +1,7 @@
1
1
  import { CharacterItemEquipmentDragonInfoDto } from './characterItemEquipmentDragonInfoDto';
2
2
  import { CharacterItemEquipmentInfoDto } from './characterItemEquipmentInfoDto';
3
3
  import { CharacterItemEquipmentMechanicInfoDto } from './characterItemEquipmentMechanicInfoDto';
4
+ import { CharacterItemEquipmentMedalShapeDto } from './characterItemEquipmentMedalShapeDto';
4
5
  import { CharacterItemEquipmentTitleDto } from './characterItemEquipmentTitleDto';
5
6
  import { CharacterItemEquipmentDtoBody } from '../../response/character/characterItemEquipmentDtoBody';
6
7
  /**
@@ -43,6 +44,10 @@ declare class CharacterItemEquipmentDto {
43
44
  * 칭호 정보
44
45
  */
45
46
  title: CharacterItemEquipmentTitleDto | null;
47
+ /**
48
+ * 외형 설정에 등록한 훈장 외형 정보
49
+ */
50
+ medalShape: CharacterItemEquipmentMedalShapeDto | null;
46
51
  /**
47
52
  * 에반 드래곤 장비 정보 (에반인 경우 응답)
48
53
  */
@@ -0,0 +1,32 @@
1
+ import { CharacterItemEquipmentMedalShapeDtoBody } from '../../response/character/characterItemEquipmentDtoBody';
2
+ /**
3
+ * 캐릭터 외형 설정에 등록한 훈장 외형 정보
4
+ */
5
+ declare class CharacterItemEquipmentMedalShapeDto {
6
+ /**
7
+ * 외형 설정에 등록한 훈장 장비 명
8
+ */
9
+ medalShapeName: string;
10
+ /**
11
+ * 외형 설정에 등록한 훈장 아이콘
12
+ */
13
+ medalShapeIcon: string;
14
+ /**
15
+ * 외형 설정에 등록한 훈장 설명
16
+ */
17
+ medalShapeDescription: string;
18
+ /**
19
+ * 외형 설정에 등록한 훈장의 모루 적용 장비 명
20
+ */
21
+ medalShapeChangedName: string;
22
+ /**
23
+ * 외형 설정에 등록한 훈장의 모루 적용 아이콘
24
+ */
25
+ medalShapeChangedIcon: string;
26
+ /**
27
+ * 외형 설정에 등록한 훈장의 모루 적용 훈장 설명
28
+ */
29
+ medalShapeChangedDescription: string;
30
+ constructor(obj: CharacterItemEquipmentMedalShapeDtoBody);
31
+ }
32
+ export { CharacterItemEquipmentMedalShapeDto };
@@ -27,6 +27,18 @@ declare class CharacterItemEquipmentTitleDto {
27
27
  * 칭호 옵션 유효 기간 만료 여부
28
28
  */
29
29
  isOptionExpired: boolean | null;
30
+ /**
31
+ * 외형 설정에 등록한 칭호 장비 명
32
+ */
33
+ titleShapeName: string | null;
34
+ /**
35
+ * 외형 설정에 등록한 칭호 아이콘
36
+ */
37
+ titleShapeIcon: string | null;
38
+ /**
39
+ * 외형 설정에 등록한 칭호 설명
40
+ */
41
+ titleShapeDescription: string | null;
30
42
  constructor(obj: CharacterItemEquipmentTitleDtoBody);
31
43
  }
32
44
  export { CharacterItemEquipmentTitleDto };
@@ -0,0 +1,12 @@
1
+ import { UnionChampionBadgeInfoDtoBody } from '../../response/union/unionChampionDtoBody';
2
+ /**
3
+ * 유니온 챔피언 휘장 정보
4
+ */
5
+ declare class UnionChampionBadgeInfoDto {
6
+ /**
7
+ * 유니온 챔피언 휘장 효과
8
+ */
9
+ stat: string;
10
+ constructor(obj: UnionChampionBadgeInfoDtoBody);
11
+ }
12
+ export { UnionChampionBadgeInfoDto };
@@ -0,0 +1,22 @@
1
+ import { UnionChampionBadgeInfoDto } from './unionChampionBadgeInfoDto';
2
+ import { UnionChampionInfoDto } from './unionChampionInfoDto';
3
+ import { UnionChampionDtoBody } from '../../response/union/unionChampionDtoBody';
4
+ /**
5
+ * 유니온 챔피언 정보
6
+ */
7
+ declare class UnionChampionDto {
8
+ /**
9
+ * 조회 기준일
10
+ */
11
+ date: Date | null;
12
+ /**
13
+ * 유니온 챔피언 정보
14
+ */
15
+ unionChampion: UnionChampionInfoDto[];
16
+ /**
17
+ * 유니온 챔피언 휘장 정보
18
+ */
19
+ championBadgeTotalInfo: UnionChampionBadgeInfoDto[];
20
+ constructor(obj: UnionChampionDtoBody);
21
+ }
22
+ export { UnionChampionDto };
@@ -0,0 +1,25 @@
1
+ import { UnionChampionBadgeInfoDto } from './unionChampionBadgeInfoDto';
2
+ import { UnionChampionInfoDtoBody } from '../../response/union/unionChampionDtoBody';
3
+ /**
4
+ * 유니온 챔피언 상세 정보
5
+ */
6
+ declare class UnionChampionInfoDto {
7
+ /**
8
+ * 유니온 챔피언 슬롯
9
+ */
10
+ championSlot: number;
11
+ /**
12
+ * 유니온 챔피언 등급
13
+ */
14
+ championGrade: string;
15
+ /**
16
+ * 유니온 챔피언 캐릭터의 직업
17
+ */
18
+ championClass: string;
19
+ /**
20
+ * 챔피언 휘장 효과
21
+ */
22
+ championBadgeInfo: UnionChampionBadgeInfoDto[];
23
+ constructor(obj: UnionChampionInfoDtoBody);
24
+ }
25
+ export { UnionChampionInfoDto };
@@ -43,6 +43,7 @@ import { UnionRankingResponseDto } from './dto/ranking/unionRankingResponseDto';
43
43
  import { UnionArtifactDto } from './dto/union/unionArtifactDto';
44
44
  import { UnionDto } from './dto/union/unionDto';
45
45
  import { UnionRaiderDto } from './dto/union/unionRaiderDto';
46
+ import { UnionChampionDto } from './dto/union/unionChampionDto';
46
47
  /**
47
48
  * MapleStory OpenAPI client.<br>
48
49
  * This is an implementation of <a href="https://openapi.nexon.com/game/maplestory">MapleStory API</a>
@@ -339,6 +340,18 @@ declare class MapleStoryApi {
339
340
  * @param dateOptions 조회 기준일 (KST)
340
341
  */
341
342
  getUnionArtifact(ocid: string, dateOptions?: DateOptions): Promise<UnionArtifactDto>;
343
+ /**
344
+ * 유니온 챔피언 정보를 조회합니다.<br>
345
+ * 유니온 챔피언 정보는 2025년 2월 20일 메이플스토리 점검 이후 데이터부터 조회 가능합니다.<br>
346
+ * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
347
+ * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
348
+ * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
349
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
350
+ *
351
+ * @param ocid 캐릭터 식별자
352
+ * @param dateOptions 조회 기준일 (KST)
353
+ */
354
+ getUnionChampion(ocid: string, dateOptions?: DateOptions): Promise<UnionChampionDto>;
342
355
  /**
343
356
  * 길드 식별자(oguild_id) 정보를 조회합니다.
344
357
  * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
@@ -25,6 +25,7 @@ type CharacterCashItemEquipmentPresetDtoBody = {
25
25
  cash_item_label: string | null;
26
26
  cash_item_coloring_prism: CharacterCashItemEquipmentColoringPrismDtoBody | null;
27
27
  item_gender: string | null;
28
+ skills: string[];
28
29
  };
29
30
  type CharacterCashItemEquipmentOptionDtoBody = {
30
31
  option_type: string;
@@ -8,6 +8,7 @@ type CharacterItemEquipmentDtoBody = {
8
8
  item_equipment_preset_2: CharacterItemEquipmentInfoDtoBody[] | null;
9
9
  item_equipment_preset_3: CharacterItemEquipmentInfoDtoBody[] | null;
10
10
  title: CharacterItemEquipmentTitleDtoBody | null;
11
+ medal_shape: CharacterItemEquipmentMedalShapeDtoBody | null;
11
12
  dragon_equipment: CharacterItemEquipmentInfoDtoBody[];
12
13
  mechanic_equipment: CharacterItemEquipmentInfoDtoBody[];
13
14
  };
@@ -109,7 +110,7 @@ type CharacterItemEquipmentExceptionalOptionDtoBody = {
109
110
  max_mp: string;
110
111
  attack_power: string;
111
112
  magic_power: string;
112
- exceptional_upgrade: number;
113
+ exceptional_upgrade: number | null;
113
114
  };
114
115
  type CharacterItemEquipmentTotalOptionDtoBody = {
115
116
  str: string;
@@ -187,5 +188,16 @@ type CharacterItemEquipmentTitleDtoBody = {
187
188
  title_description: string;
188
189
  date_expire: string | null;
189
190
  date_option_expire: string | null;
191
+ title_shape_name: string | null;
192
+ title_shape_icon: string | null;
193
+ title_shape_description: string | null;
190
194
  };
191
- export type { CharacterItemEquipmentDtoBody, CharacterItemEquipmentInfoDtoBody, CharacterItemEquipmentTitleDtoBody, CharacterItemEquipmentOptionDtoBody, CharacterItemEquipmentExceptionalOptionDtoBody, CharacterItemEquipmentTotalOptionDtoBody, CharacterItemEquipmentBaseOptionDtoBody, CharacterItemEquipmentAddOptionDtoBody, CharacterItemEquipmentEtcOptionDtoBody, CharacterItemEquipmentStarforceOptionDtoBody, CharacterItemEquipmentDragonInfoDtoBody, CharacterItemEquipmentMechanicInfoDtoBody, };
195
+ type CharacterItemEquipmentMedalShapeDtoBody = {
196
+ medal_shape_name: string;
197
+ medal_shape_icon: string;
198
+ medal_shape_description: string;
199
+ medal_shape_changed_name: string;
200
+ medal_shape_changed_icon: string;
201
+ medal_shape_changed_description: string;
202
+ };
203
+ export type { CharacterItemEquipmentDtoBody, CharacterItemEquipmentInfoDtoBody, CharacterItemEquipmentTitleDtoBody, CharacterItemEquipmentOptionDtoBody, CharacterItemEquipmentExceptionalOptionDtoBody, CharacterItemEquipmentTotalOptionDtoBody, CharacterItemEquipmentMedalShapeDtoBody, CharacterItemEquipmentBaseOptionDtoBody, CharacterItemEquipmentAddOptionDtoBody, CharacterItemEquipmentEtcOptionDtoBody, CharacterItemEquipmentStarforceOptionDtoBody, CharacterItemEquipmentDragonInfoDtoBody, CharacterItemEquipmentMechanicInfoDtoBody, };
@@ -0,0 +1,15 @@
1
+ type UnionChampionDtoBody = {
2
+ date: string;
3
+ union_champion: UnionChampionInfoDtoBody[];
4
+ champion_badge_total_info: UnionChampionBadgeInfoDtoBody[];
5
+ };
6
+ type UnionChampionInfoDtoBody = {
7
+ champion_slot: number;
8
+ champion_grade: string;
9
+ champion_class: string;
10
+ champion_badge_info: UnionChampionBadgeInfoDtoBody[];
11
+ };
12
+ type UnionChampionBadgeInfoDtoBody = {
13
+ stat: string;
14
+ };
15
+ export { UnionChampionDtoBody, UnionChampionInfoDtoBody, UnionChampionBadgeInfoDtoBody, };