finej3 1.0.15 → 2.0.0

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.
Files changed (47) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +137 -111
  3. package/dist/cjs/clients/client.d.ts +94 -0
  4. package/dist/cjs/clients/client.js +52 -51
  5. package/dist/cjs/clients/client.js.map +1 -1
  6. package/dist/cjs/clients/main.d.ts +410 -0
  7. package/dist/cjs/clients/main.js +247 -332
  8. package/dist/cjs/clients/main.js.map +1 -1
  9. package/dist/cjs/clients/search.d.ts +101 -0
  10. package/dist/cjs/clients/search.js +39 -48
  11. package/dist/cjs/clients/search.js.map +1 -1
  12. package/dist/cjs/core/http.d.ts +41 -0
  13. package/dist/cjs/core/http.js +33 -21
  14. package/dist/cjs/core/http.js.map +1 -1
  15. package/dist/cjs/index.d.ts +48 -0
  16. package/dist/cjs/index.js +4 -2
  17. package/dist/cjs/index.js.map +1 -1
  18. package/dist/cjs/types/client.d.ts +239 -0
  19. package/dist/cjs/types/main.d.ts +1174 -0
  20. package/dist/cjs/types/search.d.ts +331 -0
  21. package/dist/esm/clients/client.d.ts +76 -60
  22. package/dist/esm/clients/client.d.ts.map +1 -1
  23. package/dist/esm/clients/client.js +52 -51
  24. package/dist/esm/clients/client.js.map +1 -1
  25. package/dist/esm/clients/main.d.ts +332 -469
  26. package/dist/esm/clients/main.d.ts.map +1 -1
  27. package/dist/esm/clients/main.js +247 -332
  28. package/dist/esm/clients/main.js.map +1 -1
  29. package/dist/esm/clients/search.d.ts +81 -66
  30. package/dist/esm/clients/search.d.ts.map +1 -1
  31. package/dist/esm/clients/search.js +39 -48
  32. package/dist/esm/clients/search.js.map +1 -1
  33. package/dist/esm/core/http.d.ts +22 -42
  34. package/dist/esm/core/http.d.ts.map +1 -1
  35. package/dist/esm/core/http.js +32 -21
  36. package/dist/esm/core/http.js.map +1 -1
  37. package/dist/esm/index.d.ts +11 -10
  38. package/dist/esm/index.d.ts.map +1 -1
  39. package/dist/esm/index.js +2 -1
  40. package/dist/esm/index.js.map +1 -1
  41. package/dist/esm/types/client.d.ts +217 -117
  42. package/dist/esm/types/client.d.ts.map +1 -1
  43. package/dist/esm/types/main.d.ts +826 -1040
  44. package/dist/esm/types/main.d.ts.map +1 -1
  45. package/dist/esm/types/search.d.ts +287 -236
  46. package/dist/esm/types/search.d.ts.map +1 -1
  47. package/package.json +48 -43
@@ -2,424 +2,339 @@
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.Jx3Api = exports.MAIN_BASE_URL = void 0;
4
4
  const http_js_1 = require("../core/http.js");
5
- /** 主站官方地址 */
6
- exports.MAIN_BASE_URL = "https://seasun.nicemoe.cn";
7
- /**
8
- * JX3API 主站客户端(seasun.nicemoe.cn,GET + query)。
9
- *
10
- * - 响应信封 `{ code, msg, data, time }` 原样返回,不解包、业务错误不抛异常(自行判断 code)。
11
- * - 所有方法自动注入 token;推栏相关方法自动注入配置中的 ticket(可在参数中覆盖)。
12
- * - 榜单类接口 server 为可选筛选条件:指定 server 时 data 为单个对象,
13
- * 不指定时 data 为数组(已用方法重载表达)。
14
- * - 传 `baseUrl` 可指向自建代理 / 镜像,缺省用 {@link MAIN_BASE_URL}。
15
- */
5
+ /** 新版主站服务入口。 */
6
+ exports.MAIN_BASE_URL = 'https://nico.nicemoe.cn';
7
+ /** 响应保留 { status, detail };使用 isSuccess 判断成功后读取业务数据。 */
16
8
  class Jx3Api extends http_js_1.HttpClient {
17
- constructor(options) {
9
+ constructor(options = {}) {
18
10
  super(exports.MAIN_BASE_URL, options);
19
11
  }
20
12
  activeCalendar(params = {}) {
21
- return this.get('/active/calendar', params);
13
+ return this.get('/active/calendar', { ...params });
22
14
  }
23
- /** 地图活动:楚天社 / 云从社 / 披风会接下来 10 条排期 */
15
+ /** 地图活动。查询指定地图活动当前及后续的 10 条安排,时间为北京时间。 */
24
16
  activeCelebs(params) {
25
- return this.get('/active/celebs', params);
17
+ return this.get('/active/celebs', { ...params });
26
18
  }
27
- /** 关隘首领状态,按服务器分组 */
28
- castleStatus() {
29
- return this.get('/castle/status', {});
19
+ /** 名剑排行。查询名剑大会周排行榜。 */
20
+ arenaAwesome(params = {}) {
21
+ return this.get('/arena/awesome', { ...params, ticket: this.requireTicket(params.ticket, '/arena/awesome') });
30
22
  }
31
- /** 今日赤兔记录 */
32
- chituRecords() {
33
- return this.get('/chitu/records', {});
23
+ /** 名剑战绩。查询角色名剑大会表现及近期战绩。 */
24
+ arenaRecent(params) {
25
+ return this.get('/arena/recent', { ...params, ticket: this.requireTicket(params.ticket, '/arena/recent') });
34
26
  }
35
- /** 本周赤兔到达地图 */
36
- chituWeekRecords() {
37
- return this.get('/chitu/week/records', {});
27
+ /** 名剑统计。查询各门派的名剑大会周统计。 */
28
+ arenaSchools(params = {}) {
29
+ return this.get('/arena/schools', { ...params, ticket: this.requireTicket(params.ticket, '/arena/schools') });
38
30
  }
39
- /** 阵营奉献:据点争夺记录 */
40
- fenxianRecords(params = {}) {
41
- return this.get('/fenxian/records', params);
31
+ /** 阵营拍卖。查询阵营拍卖成交记录。 */
32
+ auctionRecords(params) {
33
+ return this.get('/auction/records', { ...params });
42
34
  }
43
- /** 烟花记录 */
44
- fireworkRecords(params) {
45
- return this.get('/firework/records', params);
35
+ /** 帮战记录。查询服务器最近 30 场帮战。 */
36
+ battleRecords(params) {
37
+ return this.get('/battle/records', { ...params });
46
38
  }
47
- /** 马场预告:各地图下一匹的预计时刻 */
48
- ranchChat(params) {
49
- return this.get('/ranch/chat', params);
50
- }
51
- /**
52
- * 马场事件:各地图的出世预告及本周期出世备注。
53
- * 响应的 `data` 包含 `zone`、`server`、`data` 和 `note`;
54
- * 其中内层 `data` 按地图分组,键可能附带进图时间,值为预告文本数组。
55
- *
56
- * @example
57
- * ```ts
58
- * const response = await api.ranchRecords({ server: '破阵子' });
59
- * if (response.code === 200) {
60
- * for (const [map, records] of Object.entries(response.data.data)) {
61
- * console.log(map, records);
62
- * }
63
- * console.log(response.data.note);
64
- * }
65
- * ```
66
- */
67
- ranchRecords(params) {
68
- return this.get('/ranch/records', params);
39
+ /** 名片缓存。查询已缓存的角色名片。 */
40
+ cardCached(params) {
41
+ return this.get('/card/cached', { ...params });
69
42
  }
70
- /** 下次扶摇:指定服返回该服未来场次,否则全服各返回下一场 */
71
- soarNext(params = {}) {
72
- return this.get('/soar/next', { limit: 10, ...params });
43
+ /** 名片详情。查询角色名片图片与获赞数。 */
44
+ cardDetail(params) {
45
+ return this.get('/card/detail', { ...params, ticket: this.requireTicket(params.ticket, '/card/detail') });
73
46
  }
74
- /** 诛恶事件刷新记录 */
75
- wickedRecords(params = {}) {
76
- return this.get('/wicked/records', params);
47
+ /** 随机名片。随机获取一张角色名片。 */
48
+ cardRandom(params = {}) {
49
+ return this.get('/card/random', { ...params });
77
50
  }
78
- /** 名剑排行:某比赛模式竞技场排行榜前 limit 名 */
79
- arenaAwesome(params = {}) {
80
- const { ticket, ...rest } = params;
81
- return this.get('/arena/awesome', { mode: 33, limit: 20, ...rest, ticket: this.requireTicket(ticket, '/arena/awesome') });
51
+ /** 名片记录。查询角色名片。 */
52
+ cardRecord(params) {
53
+ return this.get('/card/record', { ...params });
82
54
  }
83
- arenaRecent(params) {
84
- const { ticket, ...rest } = params;
85
- return this.get('/arena/recent', { ...rest, ticket: this.requireTicket(ticket, '/arena/recent') });
55
+ /** 名片历史。查询角色的历史名片。 */
56
+ cardRecords(params) {
57
+ return this.get('/card/records', { ...params });
86
58
  }
87
- /** 名剑统计:某比赛模式下各门派的竞技场周统计 */
88
- arenaSchools(params = {}) {
89
- const { ticket, ...rest } = params;
90
- return this.get('/arena/schools', { mode: 33, ...rest, ticket: this.requireTicket(ticket, '/arena/schools') });
59
+ /** 角色聊天。分页查询角色聊天记录。 */
60
+ chatRecords(params) {
61
+ return this.get('/chat/records', { ...params });
91
62
  }
92
- rankArena(params = {}) {
93
- return this.get('/rank/arena', params);
63
+ /** 今日赤兔。查询今日赤兔预告与出世记录。 */
64
+ chituRecords() {
65
+ return this.get('/chitu/records', {});
94
66
  }
95
- rankChampionship(params = {}) {
96
- return this.get('/rank/championship', params);
67
+ /** 本周赤兔。查询本周赤兔预告与出世记录,每周二 07:00(北京时间)重置。 */
68
+ chituWeekRecords() {
69
+ return this.get('/chitu/week/records', {});
97
70
  }
98
- rankConstable(params = {}) {
99
- return this.get('/rank/constable', params);
71
+ /** 答案之书。随机获取一条答案和一句鼓励语。 */
72
+ choiceAnswer() {
73
+ return this.get('/choice/answer', {});
100
74
  }
101
- rankOutlaw(params = {}) {
102
- return this.get('/rank/outlaw', params);
75
+ /** 喝什么。随机推荐 2~4 种饮品。 */
76
+ choiceDrink() {
77
+ return this.get('/choice/drink', {});
103
78
  }
104
- rankStatistics(params) {
105
- return this.get('/rank/statistics', params);
79
+ /** 吃什么。随机推荐 2~4 种食物。 */
80
+ choiceFood() {
81
+ return this.get('/choice/food', {});
106
82
  }
107
- rankTrials(params) {
108
- return this.get('/rank/trials', params);
83
+ /** 编辑器。查询编辑器资料。 */
84
+ editorSearch(params) {
85
+ return this.get('/editor/search', { ...params, page: params.page ?? 1 });
109
86
  }
110
- rankWanted(params = {}) {
111
- return this.get('/rank/wanted', params);
87
+ /** 奇遇汇总。汇总服务器近期的奇遇次数及最近触发记录。 */
88
+ eventCollect(params) {
89
+ return this.get('/event/collect', { ...params });
112
90
  }
113
- /** 赛季试炼:各赛季的最高层数与首领列表(无需参数) */
114
- trialSeasons() {
115
- return this.get('/trial/seasons', {});
91
+ /** 近期奇遇。查询服务器最近的奇遇触发记录。 */
92
+ eventRecent(params) {
93
+ return this.get('/event/recent', { ...params });
116
94
  }
117
- /**
118
- * 试炼秒伤:指定赛季 + 层数下各首领的血量与完美 / 通关秒伤需求。
119
- * 赛季名与可用层数见 {@link Jx3Api.trialSeasons}。
120
- */
121
- trialBosses(params) {
122
- return this.get('/trial/bosses', params);
95
+ /** 奇遇记录。查询角色的奇遇触发记录。 */
96
+ eventRecords(params) {
97
+ return this.get('/event/records', { ...params });
123
98
  }
124
- /** 资历榜单:指定服 / 门派(默认全服全门派)的资历前 100 名 */
125
- schoolSeniority(params = {}) {
126
- const { ticket, ...rest } = params;
127
- return this.get('/school/seniority', { ...rest, ticket: this.requireTicket(ticket, '/school/seniority') });
99
+ /** 奇遇统计。查询指定奇遇最近的触发记录。 */
100
+ eventStatistics(params) {
101
+ return this.get('/event/statistics', { ...params });
128
102
  }
129
- tuilanAchievement(params) {
130
- const { ticket, ...rest } = params;
131
- return this.get('/tuilan/achievement', { ...rest, ticket: ticket ?? this.options.ticket });
103
+ /** 奇遇攻略。查询奇遇的分类和等级资料。 */
104
+ eventStrategy(params) {
105
+ return this.get('/event/strategy', { ...params });
132
106
  }
133
- /** 角色徽章,需要 LV.2 及以上的站点 token 和推栏 ticket。 */
134
- tuilanBadge(params) {
135
- const { ticket, ...rest } = params;
136
- return this.get('/tuilan/badge', { ...rest, ticket: this.requireTicket(ticket, '/tuilan/badge') });
107
+ /** 科举答案。搜索科举试题及答案。 */
108
+ examSearch(params) {
109
+ return this.get('/exam/search', { ...params });
137
110
  }
138
- /** 阵营拍卖记录 */
139
- auctionRecords(params) {
140
- return this.get('/auction/records', params);
111
+ /** 烟花记录。查询角色发送或接收的烟花记录。 */
112
+ fireworkRecords(params) {
113
+ return this.get('/firework/records', { ...params });
141
114
  }
142
- /** 的卢拍卖:指定服最新 10 条,不指定则每服最新 1 条 */
143
- steedRecords(params = {}) {
144
- return this.get('/steed/records', params);
115
+ /** 小吃小药。查询心法的小吃小药。 */
116
+ foodList(params = {}) {
117
+ return this.get('/food/list', { ...params });
145
118
  }
146
- /** 金价行情 */
147
- tradeDemon(params = {}) {
148
- return this.get('/trade/demon', params);
119
+ /** 骗子查询。查询角色 UID 对应的骗子记录。 */
120
+ fraudDetail(params) {
121
+ return this.get('/fraud/detail', { ...params });
149
122
  }
150
- /** 外观价格:历史成交 + 万宝楼挂单 */
151
- tradeItemRecords(params) {
152
- return this.get('/trade/item/records', params);
123
+ /** 家园鲜花。查询各家园地图的鲜花收购信息。 */
124
+ homeFlower(params) {
125
+ return this.get('/home/flower', { ...params });
153
126
  }
154
- /** 外观搜索(先精确后模糊) */
155
- tradeItemSearch(params) {
156
- return this.get('/trade/item/search', params);
127
+ /** 秘境方位。查询当前秘境方位及下次变化的倒计时。 */
128
+ mechDecrypt() {
129
+ return this.get('/mech/decrypt', {});
157
130
  }
158
- /** 成本计算:按成品配方算材料成本 */
159
- tradeManufacture(params) {
160
- return this.get('/trade/manufacture', params);
131
+ /** 师徒列表。查询服务器的师徒招募信息。 */
132
+ mentorSearch(params) {
133
+ return this.get('/mentor/search', { ...params });
161
134
  }
162
- /** 物品价格:各区 / 指定服历史成交价 */
163
- tradeRecords(params) {
164
- return this.get('/trade/records', params);
135
+ /** 角色百战。查询角色的百战技能、体力、精力和场次。 */
136
+ monsterRecords(params) {
137
+ return this.get('/monster/records', { ...params });
165
138
  }
166
- /** 万宝楼编号搜索:角色信息、售价与调价记录 */
167
- tradeWanbaolou(params) {
168
- return this.get('/trade/wanbaolou', params);
139
+ /** 百战首领。查询本周百战首领、技能及效果。 */
140
+ monsterWeekly() {
141
+ return this.get('/monster/weekly', {});
169
142
  }
170
- /**
171
- * 万宝楼角色信息:按编号转发上游 role_info2 接口,服务端固定 type=3。
172
- * `id` 使用字符串以避免大整数精度丢失;需要 LV.2 及以上的站点 token,无需 ticket。
173
- * 保留上游字段与 `{ code, data }` 结构,角色列表位于 `response.data.data`。
174
- */
175
- wblzsRole(params) {
176
- return this.get('/wblzs/role', params);
143
+ /** 维护公告。查询游戏维护更新公告。 */
144
+ newsAnnounce(params = {}) {
145
+ return this.get('/news/announce', { ...params });
177
146
  }
178
- /** 万宝楼找人:按订单编号查询详情与匹配角色(需要推栏 ticket) */
179
- wblzsSomeone(params) {
180
- const { ticket, ...rest } = params;
181
- return this.get('/wblzs/someone', { ...rest, ticket: this.requireTicket(ticket, '/wblzs/someone') });
147
+ /** 新闻资讯。查询最新游戏新闻资讯。 */
148
+ newsRecords(params = {}) {
149
+ return this.get('/news/records', { ...params });
182
150
  }
183
- /** 帮战记录:某服最近 30 场 */
184
- battleRecords(params) {
185
- return this.get('/battle/records', params);
151
+ /** 马场预告。查询各地图 NPC 播报的马匹预计出世时间。 */
152
+ ranchChat(params) {
153
+ return this.get('/ranch/chat', { ...params });
186
154
  }
187
- /** 沙盘据点归属 */
188
- sandRecords(params) {
189
- return this.get('/sand/records', params);
155
+ /** 马场事件。查询马场预告及本周期赤兔、的卢出世情况。 */
156
+ ranchRecords(params) {
157
+ return this.get('/ranch/records', { ...params });
190
158
  }
191
- /** 名片缓存 */
192
- cardCached(params) {
193
- return this.get('/card/cached', params);
159
+ /** 绝境战场。查询绝境战场榜单。 */
160
+ rankBattle(params) {
161
+ return this.get('/rank/battle', { ...params });
194
162
  }
195
- /** 名片预设(推栏预设图与获赞数) */
196
- cardPreset(params) {
197
- const { ticket, ...rest } = params;
198
- return this.get('/card/preset', { ...rest, ticket: this.requireTicket(ticket, '/card/preset') });
163
+ /** 据点贡献。查询据点贡献榜。 */
164
+ rankCastle(params) {
165
+ return this.get('/rank/castle', { ...params });
199
166
  }
200
- /** 随机名片 */
201
- cardRandom(params = {}) {
202
- return this.get('/card/random', params);
167
+ /** 武林争霸。查询指定阵营的武林争霸榜单。 */
168
+ rankContest(params = {}) {
169
+ return this.get('/rank/contest', { ...params });
203
170
  }
204
- /** 名片记录 */
205
- cardRecord(params) {
206
- return this.get('/card/record', params);
171
+ /** 帮会排行。查询帮会排行与战功榜。 */
172
+ rankGuild(params) {
173
+ return this.get('/rank/guild', { ...params });
207
174
  }
208
- /** 名片历史列表 */
209
- cardRecords(params) {
210
- return this.get('/card/records', params);
175
+ /** 江湖排行。查询江湖浪客与捕快荣誉榜。 */
176
+ rankJianghu(params) {
177
+ return this.get('/rank/jianghu', { ...params });
211
178
  }
212
- /** 奇遇汇总:白名单奇遇近 num 天触发次数 + 最新一条 */
213
- eventCollect(params) {
214
- return this.get('/event/collect', params);
179
+ /** 跨服名剑。查询跨服名剑榜单。 */
180
+ rankLadder(params = {}) {
181
+ return this.get('/rank/ladder', { ...params });
215
182
  }
216
- /** 该角色尚未触发的奇遇 */
217
- eventMissing(params) {
218
- return this.get('/event/missing', params);
183
+ /** 个人排行。查询个人排行与贡献榜。 */
184
+ rankRecords(params) {
185
+ return this.get('/rank/records', { ...params });
219
186
  }
220
- /** 某服最近触发的奇遇 */
221
- eventRecent(params) {
222
- return this.get('/event/recent', params);
187
+ /** 试炼之地。查询指定心法的试炼之地榜单。 */
188
+ rankTrials(params) {
189
+ return this.get('/rank/trials', { ...params });
223
190
  }
224
- /** 角色奇遇记录 */
225
- eventRecords(params) {
226
- return this.get('/event/records', params);
191
+ /** 决斗挑战。查询公开或私密的决斗挑战榜单。 */
192
+ rankWanted(params = {}) {
193
+ return this.get('/rank/wanted', { ...params });
227
194
  }
228
- /** 某奇遇最近的触发记录 */
229
- eventStatistics(params) {
230
- return this.get('/event/statistics', params);
195
+ /** 团队招募。查询服务器的团队招募信息。 */
196
+ recruitSearch(params) {
197
+ return this.get('/recruit/search', { ...params });
231
198
  }
232
- /** 奇遇攻略(白名单配置) */
233
- eventStrategy(params) {
234
- return this.get('/event/strategy', params);
199
+ /** 掉落统计。查询物品的掉落记录。 */
200
+ rewardStatistics(params) {
201
+ return this.get('/reward/statistics', { ...params });
235
202
  }
236
- /** 角色百战技能配装:体力 / 精力属性与技能列表。未打过百战的角色会返回 404 未收录 */
237
- monsterRecords(params) {
238
- return this.get('/monster/records', params);
239
- }
240
- /**
241
- * 本周百战异闻录:本周首领与 100 层关卡(无需 server / name)。
242
- *
243
- * 「百战记录」分组下后端新增的接口,晚于最初的接口文档,故原始文档中没有;
244
- * 字段依据实测。
245
- */
246
- monsterWeekly() {
247
- return this.get('/monster/weekly', {});
203
+ /** 角色详情。查询角色资料,可附带角色名和帮会历史。 */
204
+ roleDetail(params) {
205
+ return this.get('/role/detail', { ...params });
248
206
  }
249
- /**
250
- * 成就查询:角色名片 + 按 `name` 模糊匹配的成就列表,标记该角色完成情况。
251
- * `role` 为角色名,`name` 为成就名/分类关键词。
252
- */
253
- roleAchievement(params) {
254
- return this.get('/role/achievement', params);
207
+ /** 全服角色。查询全服已收录的同名角色。 */
208
+ roleDetails(params) {
209
+ return this.get('/role/details', { ...params });
255
210
  }
256
- /** 角色详情(history=1 时附改名 / 帮会历史) */
257
- roleDetail(params) {
258
- return this.get('/role/detail', params);
211
+ /** 沙盘据点。查询据点归属及本周祭祀次数。 */
212
+ sandRecords(params) {
213
+ return this.get('/sand/records', { ...params });
259
214
  }
260
- /** 蹲宠查询:七宠白名单命中情况 */
261
- shareStay(params) {
262
- return this.get('/share/stay', params);
215
+ /** 舔狗日志。随机获取一条舔狗日志。 */
216
+ saohuaContent() {
217
+ return this.get('/saohua/content', {});
263
218
  }
264
- /**
265
- * 聊天内容:查询角色在所有服务器的聊天记录,由服务端合并去重并按时间倒序分页。
266
- * `limit` 默认 20,`page` 默认 1;需要 LV.2 及以上的站点 token。
267
- */
268
- chatContent(params) {
269
- return this.get('/chat/content', { limit: 20, page: 1, ...params });
219
+ /** 分类语录。按分类随机获取一条语录。 */
220
+ saohuaContext(params) {
221
+ return this.get('/saohua/context', { ...params });
270
222
  }
271
- /** 统战歪歪:各服 YY 语音在线主播 */
272
- duowanStatistics(params = {}) {
273
- return this.get('/duowan/statistics', params);
223
+ /** 随机骚话。随机获取一条骚话。 */
224
+ saohuaRandom() {
225
+ return this.get('/saohua/random', {});
274
226
  }
275
- /** 小吃小药(指定心法或全部) */
276
- foodList(params = {}) {
277
- return this.get('/food/list', params);
227
+ /** 渣男语录。随机获取一条渣男语录。 */
228
+ saohuaZhanan() {
229
+ return this.get('/saohua/zhanan', {});
278
230
  }
279
- /** 骗子查询:按 UID 查风控记录 */
280
- fraudDetail(params) {
281
- return this.get('/fraud/detail', params);
231
+ /** 配装搜索。查询指定心法的推荐配装。 */
232
+ schoolSearch(params) {
233
+ return this.get('/school/search', { ...params, ticket: this.requireTicket(params.ticket, '/school/search') });
282
234
  }
283
- /** 家园鲜花行情,按地图归组 */
284
- homeFlower(params) {
285
- return this.get('/home/flower', params);
286
- }
287
- /**
288
- * 家园装饰。`name` 必须是完整精确的装饰名(如 "龙门香梦"),
289
- * 模糊名会返回 `code: 400 参数不正确`。返回数组,同名装饰可能有多条。
290
- */
291
- homeFurniture(params) {
292
- return this.get('/home/furniture', params);
293
- }
294
- /**
295
- * 器物图谱。`name` 必须是完整精确的器物名(如 "日晷"),
296
- * 模糊名会返回 `code: 400 参数不正确`。返回数组,结构与 {@link Jx3Api.homeFurniture} 一致。
297
- */
298
- homeTravel(params) {
299
- return this.get('/home/travel', params);
300
- }
301
- /** 师徒列表(label 1=师父 / 2=徒弟) */
302
- mentorSearch(params) {
303
- return this.get('/mentor/search', { label: 1, ...params });
235
+ /** 资历榜单。查询全服或指定服务器、门派的资历前 100 名。 */
236
+ schoolSeniority(params = {}) {
237
+ return this.get('/school/seniority', { ...params, ticket: this.requireTicket(params.ticket, '/school/seniority') });
304
238
  }
305
- /** 维护公告(标题含「版本更新」) */
306
- newsAnnounce(params = {}) {
307
- return this.get('/news/announce', params);
239
+ /** 别名搜索。查询名称对应的主服务器。 */
240
+ serverSearch(params) {
241
+ return this.get('/server/search', { ...params });
308
242
  }
309
- /** 新闻资讯 */
310
- newsRecords(params = {}) {
311
- return this.get('/news/records', params);
243
+ /** 大区状态。查询服务器的开服或在线状态。 */
244
+ serverStatusCheck(params = {}) {
245
+ return this.get('/server/status/check', { ...params });
312
246
  }
313
- /** 团队招募 */
314
- recruitSearch(params) {
315
- return this.get('/recruit/search', { label: 1, limit: 50, ...params });
247
+ /** 游戏版本。查询游戏最新版本及更新包大小。 */
248
+ serverVersionCheck() {
249
+ return this.get('/server/version/check', {});
316
250
  }
317
- /** 分类骚话语录(疯狂星期四 / 彩虹屁 / 毒鸡汤 / 朋友圈) */
318
- saohuaContext(params) {
319
- return this.get('/saohua/context', params);
251
+ /** 蹲宠查询。查询宠物最近触发时间及刷新信息。 */
252
+ shareStay(params) {
253
+ return this.get('/share/stay', { ...params });
320
254
  }
321
- /**
322
- * 随机骚话(无需参数)。「骚话语录」分组下后端新增的接口,晚于最初的接口文档,
323
- * 类型依据实测。注意返回字段是 `text`,不同于 saohuaContext 的 `content`。
324
- */
325
- saohuaRandom() {
326
- return this.get('/saohua/random', {});
255
+ /** 急速计算。计算技能在各急速档位的读条时长。 */
256
+ skillCalculate(params = {}) {
257
+ return this.get('/skill/calculate', { ...params });
327
258
  }
328
- /**
329
- * 舔狗日记(无需参数),返回一段较长的舔狗日记文本。
330
- * 同为「骚话语录」分组下后端新增的接口,返回结构与 saohuaRandom 一致(字段 `text`)。
331
- */
332
- saohuaContent() {
333
- return this.get('/saohua/content', {});
259
+ /** 技改记录。查询官方武学调整公告。 */
260
+ skillRework(params = {}) {
261
+ return this.get('/skill/rework', { ...params });
334
262
  }
335
- /** 贴吧外观记录 */
263
+ /** 扶摇记录。查询已上报的扶摇九天记录及活动状态。 */
264
+ soarRecords(params = {}) {
265
+ return this.get('/soar/records', { ...params });
266
+ }
267
+ /** 的卢拍卖。查询的卢出世、捕获与拍卖记录。 */
268
+ steedRecords(params = {}) {
269
+ return this.get('/steed/records', { ...params });
270
+ }
271
+ /** 外观记录。查询贴吧中的外观交易记录。 */
336
272
  tiebaItemRecords(params) {
337
- return this.get('/tieba/item/records', params);
273
+ return this.get('/tieba/item/records', { ...params });
274
+ }
275
+ /** 贴吧物价。查询物品在贴吧及其他渠道的最近价格记录。 */
276
+ tiebaItemSales(params) {
277
+ return this.get('/tieba/item/sales', { ...params });
338
278
  }
339
- /** 百度贴吧:按帖子类型随机取近 31 天帖子 */
279
+ /** 随机帖子。按类型随机查询近 31 天的贴吧帖子。 */
340
280
  tiebaRandom(params) {
341
- return this.get('/tieba/random', params);
281
+ return this.get('/tieba/random', { ...params });
342
282
  }
343
- /** 贴吧帖子 AI 总结 */
283
+ /** 贴吧总结。获取贴吧帖子的 AI 摘要。 */
344
284
  tiebaSummary(params) {
345
- return this.get('/tieba/summary', { id: String(params.id) });
285
+ return this.get('/tieba/summary', { ...params });
346
286
  }
347
- /** 秘境方位:按 15 分钟档推算 */
348
- mechDecrypt() {
349
- return this.get('/mech/decrypt', {});
287
+ /** 金价行情。查询各渠道的金币价格。 */
288
+ tradeDemon(params = {}) {
289
+ return this.get('/trade/demon', { ...params });
350
290
  }
351
- /** 副本掉落模拟。name 为副本名,服务端默认使用「25yx闲风雾城」。需要 LV.2 及以上的 token。 */
352
- raidDrop(params = {}) {
353
- return this.get('/raid/drop', params);
291
+ /** 外观价格。按物品全名查询成交价和寄售挂单。 */
292
+ tradeItemRecords(params) {
293
+ return this.get('/trade/item/records', { ...params });
354
294
  }
355
- /** 试炼翻牌模拟。name 为层数字符串,默认 "123" 表示依次模拟第 1、2、3 层。需要 LV.2 及以上的 token。 */
356
- raidFlip(params = {}) {
357
- return this.get('/raid/flip', params);
295
+ /** 外观搜索。搜索外观及其基础资料。 */
296
+ tradeItemSearch(params) {
297
+ return this.get('/trade/item/search', { ...params });
358
298
  }
359
- /** 团队副本 CD 列表 */
360
- raidRecords(params) {
361
- return this.get('/raid/records', params);
299
+ /** 成本计算。查询成品售价并计算配方材料成本。 */
300
+ tradeManufacture(params) {
301
+ return this.get('/trade/manufacture', { ...params });
362
302
  }
363
- /** 掉落统计:按物品名模糊匹配 */
364
- rewardStatistics(params) {
365
- return this.get('/reward/statistics', { limit: 20, ...params });
303
+ /** 物品价格。按物品名称或别名查询成交价和寄售挂单。 */
304
+ tradeRecords(params) {
305
+ return this.get('/trade/records', { ...params });
366
306
  }
367
- /** 阵眼效果 */
368
- schoolMatrix(params) {
369
- const { ticket, ...rest } = params;
370
- return this.get('/school/matrix', { ...rest, ticket: this.requireTicket(ticket, '/school/matrix') });
307
+ /** 编号搜索。按万宝楼角色编号查询寄售角色详情。 */
308
+ tradeWanbaolou(params) {
309
+ return this.get('/trade/wanbaolou', { ...params });
371
310
  }
372
- /** 推栏推荐配装 */
373
- schoolSearch(params) {
374
- const { ticket, ...rest } = params;
375
- return this.get('/school/search', { ...rest, ticket: this.requireTicket(ticket, '/school/search') });
311
+ /** 秒伤计算。查询当前赛季指定层数的首领血量与通关秒伤。 */
312
+ trialBosses(params) {
313
+ return this.get('/trial/bosses', { ...params });
376
314
  }
377
- /** 技能信息 */
378
- schoolSkills(params) {
379
- const { ticket, ...rest } = params;
380
- return this.get('/school/skills', { ...rest, ticket: this.requireTicket(ticket, '/school/skills') });
315
+ /** 赛季列表。查询当前试炼赛季及首领顺序。 */
316
+ trialSeasons() {
317
+ return this.get('/trial/seasons', {});
381
318
  }
382
- /** 奇穴信息 */
383
- schoolTalent(params) {
384
- const { ticket, ...rest } = params;
385
- return this.get('/school/talent', { ...rest, ticket: this.requireTicket(ticket, '/school/talent') });
319
+ /** 角色徽章。查询推栏角色徽章。 */
320
+ tuilanBadge(params) {
321
+ return this.get('/tuilan/badge', { ...params, ticket: this.requireTicket(params.ticket, '/tuilan/badge') });
386
322
  }
387
- /** 科举答案:按题目或拼音模糊匹配 */
388
- examSearch(params) {
389
- return this.get('/exam/search', params);
323
+ /** 统战语音。查询统战 YY 频道的在线主播。 */
324
+ voiceChannels(params = {}) {
325
+ return this.get('/voice/channels', { ...params });
390
326
  }
391
- /**
392
- * 大区状态:data 固定为数组,指定 server 时也只是数组里的单条,
393
- * 不指定则返回收录的全部大区。(文档写“指定服返回单条”,实测仍是数组)
394
- */
395
- serverStatusCheck(params = {}) {
396
- return this.get('/server/status/check', params);
327
+ /** 角色信息。按万宝楼编号查询角色信息。 */
328
+ wblzsRole(params) {
329
+ return this.get('/wblzs/role', { ...params });
397
330
  }
398
- /** 默认接口服务(服务状态自检) */
399
- siteIndex(params = {}) {
400
- return this.get('/site/index', params);
331
+ /** 搜索找人。按万宝楼订单查找卖家角色候选。 */
332
+ wblzsSomeone(params) {
333
+ return this.get('/wblzs/someone', { ...params, limit: params.limit ?? 20, range: params.range ?? -1, type: params.type ?? 2, ticket: this.requireTicket(params.ticket, '/wblzs/someone') });
401
334
  }
402
- /** 急速计算:按技能 cd 推算各急速档位 */
403
- skillCalculate(params = {}) {
404
- return this.get('/skill/calculate', params);
405
- }
406
- /**
407
- * 技改记录(无需参数):武学调整公告列表,时间倒序。
408
- * 后端新增的接口,晚于最初的接口文档,类型依据实测。
409
- */
410
- skillRework() {
411
- return this.get('/skill/rework', {});
412
- }
413
- /** 语音合成(未实测:需要用户自己的阿里云密钥) */
414
- soundConverter(params) {
415
- return this.get('/sound/converter', { ...params });
416
- }
417
- /**
418
- * 更新日常:客户端上报当日大战 / 秘境 / 团本。
419
- * 注意:这是写入型接口,会修改服务端日历数据。
420
- */
421
- updateCalendar(params) {
422
- return this.get('/update/calendar', { ...params });
335
+ /** 诛恶事件。查询诛恶事件刷新记录。 */
336
+ wickedRecords(params = {}) {
337
+ return this.get('/wicked/records', { ...params });
423
338
  }
424
339
  }
425
340
  exports.Jx3Api = Jx3Api;