uapi-browser-sdk 0.1.12 → 0.1.13

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 (74) hide show
  1. package/README.md +1 -1
  2. package/dist/internal/src/apis/ClipzyApi.d.ts +0 -12
  3. package/dist/internal/src/apis/ClipzyApi.js +15 -36
  4. package/dist/internal/src/apis/ConvertApi.d.ts +0 -8
  5. package/dist/internal/src/apis/ConvertApi.js +10 -24
  6. package/dist/internal/src/apis/DailyApi.d.ts +0 -4
  7. package/dist/internal/src/apis/DailyApi.js +5 -12
  8. package/dist/internal/src/apis/DefaultApi.d.ts +0 -20
  9. package/dist/internal/src/apis/DefaultApi.js +25 -60
  10. package/dist/internal/src/apis/GameApi.d.ts +0 -20
  11. package/dist/internal/src/apis/GameApi.js +25 -60
  12. package/dist/internal/src/apis/ImageApi.d.ts +0 -44
  13. package/dist/internal/src/apis/ImageApi.js +55 -132
  14. package/dist/internal/src/apis/MiscApi.d.ts +0 -60
  15. package/dist/internal/src/apis/MiscApi.js +75 -180
  16. package/dist/internal/src/apis/NetworkApi.d.ts +0 -40
  17. package/dist/internal/src/apis/NetworkApi.js +50 -120
  18. package/dist/internal/src/apis/PoemApi.d.ts +0 -4
  19. package/dist/internal/src/apis/PoemApi.js +5 -12
  20. package/dist/internal/src/apis/RandomApi.d.ts +0 -16
  21. package/dist/internal/src/apis/RandomApi.js +20 -48
  22. package/dist/internal/src/apis/SocialApi.d.ts +0 -32
  23. package/dist/internal/src/apis/SocialApi.js +40 -96
  24. package/dist/internal/src/apis/StatusApi.d.ts +0 -8
  25. package/dist/internal/src/apis/StatusApi.js +10 -24
  26. package/dist/internal/src/apis/TextApi.d.ts +0 -44
  27. package/dist/internal/src/apis/TextApi.js +55 -132
  28. package/dist/internal/src/apis/TranslateApi.d.ts +0 -16
  29. package/dist/internal/src/apis/TranslateApi.js +20 -48
  30. package/dist/internal/src/apis/WebParseApi.d.ts +0 -16
  31. package/dist/internal/src/apis/WebParseApi.js +20 -48
  32. package/dist/internal/src/models/GetMiscHolidayCalendar200ResponseHolidaysInner.d.ts +1 -1
  33. package/dist/internal/src/models/GetMiscWeather200Response.d.ts +1 -1
  34. package/dist/internal/src/models/PostAiTranslateRequest.d.ts +2 -2
  35. package/dist/internal/src/models/PostSearchAggregateRequest.d.ts +2 -2
  36. package/dist/internal/src/models/PostSensitiveWordAnalyze200ResponseResultsInner.d.ts +2 -2
  37. package/dist/internal/src/models/PostTextAesDecryptAdvancedRequest.d.ts +2 -2
  38. package/dist/internal/src/models/PostTextAesEncryptAdvancedRequest.d.ts +3 -3
  39. package/dist/internal/src/models/PostTextConvertRequest.d.ts +2 -2
  40. package/dist/internal/src/models/PostTranslateStream400Response.d.ts +1 -1
  41. package/dist/internal/src/runtime.js +0 -15
  42. package/dist/src/errors.d.ts +85 -0
  43. package/dist/src/errors.js +247 -0
  44. package/dist/src/index.d.ts +5 -6
  45. package/dist/src/index.js +9 -10
  46. package/internal/.openapi-generator/VERSION +1 -1
  47. package/internal/src/apis/ClipzyApi.ts +15 -39
  48. package/internal/src/apis/ConvertApi.ts +10 -26
  49. package/internal/src/apis/DailyApi.ts +5 -13
  50. package/internal/src/apis/DefaultApi.ts +25 -65
  51. package/internal/src/apis/GameApi.ts +25 -65
  52. package/internal/src/apis/ImageApi.ts +55 -143
  53. package/internal/src/apis/MiscApi.ts +75 -195
  54. package/internal/src/apis/NetworkApi.ts +50 -130
  55. package/internal/src/apis/PoemApi.ts +5 -13
  56. package/internal/src/apis/RandomApi.ts +20 -52
  57. package/internal/src/apis/SocialApi.ts +40 -104
  58. package/internal/src/apis/StatusApi.ts +10 -26
  59. package/internal/src/apis/TextApi.ts +55 -143
  60. package/internal/src/apis/TranslateApi.ts +20 -52
  61. package/internal/src/apis/WebParseApi.ts +20 -52
  62. package/internal/src/models/GetMiscHolidayCalendar200ResponseHolidaysInner.ts +1 -1
  63. package/internal/src/models/GetMiscWeather200Response.ts +1 -1
  64. package/internal/src/models/PostAiTranslateRequest.ts +2 -2
  65. package/internal/src/models/PostSearchAggregateRequest.ts +2 -2
  66. package/internal/src/models/PostSensitiveWordAnalyze200ResponseResultsInner.ts +2 -2
  67. package/internal/src/models/PostTextAesDecryptAdvancedRequest.ts +2 -2
  68. package/internal/src/models/PostTextAesEncryptAdvancedRequest.ts +3 -3
  69. package/internal/src/models/PostTextConvertRequest.ts +2 -2
  70. package/internal/src/models/PostTranslateStream400Response.ts +1 -1
  71. package/internal/src/runtime.ts +0 -18
  72. package/package.json +1 -1
  73. package/src/errors.ts +282 -0
  74. package/src/index.ts +12 -8
@@ -18,9 +18,10 @@ import { GetHistoryProgrammer200ResponseFromJSON, GetHistoryProgrammerToday200Re
18
18
  */
19
19
  export class MiscApi extends runtime.BaseAPI {
20
20
  /**
21
- * Creates request options for getHistoryProgrammer without sending the request
21
+ * 想查看程序员历史上某个特定日期发生的大事件?指定月份和日期,我们就能告诉你! ## 功能概述 通过指定月份和日期,获取该日发生的程序员相关历史事件。同样使用AI智能筛选,确保事件的相关性和重要性。
22
+ * 程序员历史事件
22
23
  */
23
- async getHistoryProgrammerRequestOpts(requestParameters) {
24
+ async getHistoryProgrammerRaw(requestParameters, initOverrides) {
24
25
  if (requestParameters['month'] == null) {
25
26
  throw new runtime.RequiredError('month', 'Required parameter "month" was null or undefined when calling getHistoryProgrammer().');
26
27
  }
@@ -36,20 +37,12 @@ export class MiscApi extends runtime.BaseAPI {
36
37
  }
37
38
  const headerParameters = {};
38
39
  let urlPath = `/history/programmer`;
39
- return {
40
+ const response = await this.request({
40
41
  path: urlPath,
41
42
  method: 'GET',
42
43
  headers: headerParameters,
43
44
  query: queryParameters,
44
- };
45
- }
46
- /**
47
- * 想查看程序员历史上某个特定日期发生的大事件?指定月份和日期,我们就能告诉你! ## 功能概述 通过指定月份和日期,获取该日发生的程序员相关历史事件。同样使用AI智能筛选,确保事件的相关性和重要性。
48
- * 程序员历史事件
49
- */
50
- async getHistoryProgrammerRaw(requestParameters, initOverrides) {
51
- const requestOptions = await this.getHistoryProgrammerRequestOpts(requestParameters);
52
- const response = await this.request(requestOptions, initOverrides);
45
+ }, initOverrides);
53
46
  return new runtime.JSONApiResponse(response, (jsonValue) => GetHistoryProgrammer200ResponseFromJSON(jsonValue));
54
47
  }
55
48
  /**
@@ -61,26 +54,19 @@ export class MiscApi extends runtime.BaseAPI {
61
54
  return await response.value();
62
55
  }
63
56
  /**
64
- * Creates request options for getHistoryProgrammerToday without sending the request
57
+ * 想知道程序员历史上的今天发生了什么大事吗?这个接口告诉你答案! ## 功能概述 我们使用AI智能筛选从海量历史事件中挑选出与程序员、计算机科学相关的重要事件。每个事件都经过重要性评分和相关性评分,确保内容质量。
58
+ * 程序员历史上的今天
65
59
  */
66
- async getHistoryProgrammerTodayRequestOpts() {
60
+ async getHistoryProgrammerTodayRaw(initOverrides) {
67
61
  const queryParameters = {};
68
62
  const headerParameters = {};
69
63
  let urlPath = `/history/programmer/today`;
70
- return {
64
+ const response = await this.request({
71
65
  path: urlPath,
72
66
  method: 'GET',
73
67
  headers: headerParameters,
74
68
  query: queryParameters,
75
- };
76
- }
77
- /**
78
- * 想知道程序员历史上的今天发生了什么大事吗?这个接口告诉你答案! ## 功能概述 我们使用AI智能筛选从海量历史事件中挑选出与程序员、计算机科学相关的重要事件。每个事件都经过重要性评分和相关性评分,确保内容质量。
79
- * 程序员历史上的今天
80
- */
81
- async getHistoryProgrammerTodayRaw(initOverrides) {
82
- const requestOptions = await this.getHistoryProgrammerTodayRequestOpts();
83
- const response = await this.request(requestOptions, initOverrides);
69
+ }, initOverrides);
84
70
  return new runtime.JSONApiResponse(response, (jsonValue) => GetHistoryProgrammerToday200ResponseFromJSON(jsonValue));
85
71
  }
86
72
  /**
@@ -92,9 +78,10 @@ export class MiscApi extends runtime.BaseAPI {
92
78
  return await response.value();
93
79
  }
94
80
  /**
95
- * Creates request options for getMiscDistrict without sending the request
81
+ * 一个接口,覆盖全球 243 个国家、中国省/市/区/街道四级行政区划,支持关键词搜索、行政编码查询、坐标反查三种查询模式(必须至少传入一种查询参数)。 ## 功能概述 根据用户输入的搜索条件快速查找行政区域信息。例如:中国 > 山东省 > 济南市 > 历下区 > 舜华路街道。 无需注册、无需密钥,直接调用即可获取结构化的行政区域数据。支持三种查询方式: - 传 `adcode`,按行政编码精确查询,同时返回下级区划列表 - 传 `lat` + `lng`,坐标反查附近地点 - 传 `keywords`,按关键词搜索,支持中英文 ## 中国与国际数据差异 中国数据包含 `adcode`、`citycode` 等字段,支持省/市/区/街道四级逐级查询;国际城市数据不含这些字段,但额外提供 `population`(人口)和 `timezone`(时区)。 > [!NOTE] > 部分城市(如东莞、文昌)没有区县层级,市级下方直接显示街道。街道级别的 `adcode` 返回的是所属区县的 `adcode`。
82
+ * Adcode 国内外行政区域查询
96
83
  */
97
- async getMiscDistrictRequestOpts(requestParameters) {
84
+ async getMiscDistrictRaw(requestParameters, initOverrides) {
98
85
  const queryParameters = {};
99
86
  if (requestParameters['keywords'] != null) {
100
87
  queryParameters['keywords'] = requestParameters['keywords'];
@@ -119,20 +106,12 @@ export class MiscApi extends runtime.BaseAPI {
119
106
  }
120
107
  const headerParameters = {};
121
108
  let urlPath = `/misc/district`;
122
- return {
109
+ const response = await this.request({
123
110
  path: urlPath,
124
111
  method: 'GET',
125
112
  headers: headerParameters,
126
113
  query: queryParameters,
127
- };
128
- }
129
- /**
130
- * 一个接口,覆盖全球 243 个国家、中国省/市/区/街道四级行政区划,支持关键词搜索、行政编码查询、坐标反查三种查询模式(必须至少传入一种查询参数)。 ## 功能概述 根据用户输入的搜索条件快速查找行政区域信息。例如:中国 > 山东省 > 济南市 > 历下区 > 舜华路街道。 无需注册、无需密钥,直接调用即可获取结构化的行政区域数据。支持三种查询方式: - 传 `adcode`,按行政编码精确查询,同时返回下级区划列表 - 传 `lat` + `lng`,坐标反查附近地点 - 传 `keywords`,按关键词搜索,支持中英文 ## 中国与国际数据差异 中国数据包含 `adcode`、`citycode` 等字段,支持省/市/区/街道四级逐级查询;国际城市数据不含这些字段,但额外提供 `population`(人口)和 `timezone`(时区)。 > [!NOTE] > 部分城市(如东莞、文昌)没有区县层级,市级下方直接显示街道。街道级别的 `adcode` 返回的是所属区县的 `adcode`。
131
- * Adcode 国内外行政区域查询
132
- */
133
- async getMiscDistrictRaw(requestParameters, initOverrides) {
134
- const requestOptions = await this.getMiscDistrictRequestOpts(requestParameters);
135
- const response = await this.request(requestOptions, initOverrides);
114
+ }, initOverrides);
136
115
  return new runtime.JSONApiResponse(response, (jsonValue) => GetMiscDistrict200ResponseFromJSON(jsonValue));
137
116
  }
138
117
  /**
@@ -144,9 +123,10 @@ export class MiscApi extends runtime.BaseAPI {
144
123
  return await response.value();
145
124
  }
146
125
  /**
147
- * Creates request options for getMiscHolidayCalendar without sending the request
126
+ * 查询指定日期、月份或年份的万年历与节假日信息。 ## 功能概述 这个接口支持三种查询方式:按天(`date`)、按月(`month`)和按年(`year`)。调用时三者选一个传入即可。 如果你只关心某一类事件,可以通过 `holiday_type` 进行筛选,例如只看法定休假/调休、公历节日、农历节日或节气。 在 `date` 模式下,传 `include_nearby=true` 可以额外返回该日期前后最近的节日;返回数量由 `nearby_limit` 控制,默认 7,最大 30。
127
+ * 查询节假日与万年历
148
128
  */
149
- async getMiscHolidayCalendarRequestOpts(requestParameters) {
129
+ async getMiscHolidayCalendarRaw(requestParameters, initOverrides) {
150
130
  const queryParameters = {};
151
131
  if (requestParameters['date'] != null) {
152
132
  queryParameters['date'] = requestParameters['date'];
@@ -171,20 +151,12 @@ export class MiscApi extends runtime.BaseAPI {
171
151
  }
172
152
  const headerParameters = {};
173
153
  let urlPath = `/misc/holiday-calendar`;
174
- return {
154
+ const response = await this.request({
175
155
  path: urlPath,
176
156
  method: 'GET',
177
157
  headers: headerParameters,
178
158
  query: queryParameters,
179
- };
180
- }
181
- /**
182
- * 查询指定日期、月份或年份的万年历与节假日信息。 ## 功能概述 这个接口支持三种查询方式:按天(`date`)、按月(`month`)和按年(`year`)。调用时三者选一个传入即可。 如果你只关心某一类事件,可以通过 `holiday_type` 进行筛选,例如只看法定休假/调休、公历节日、农历节日或节气。 在 `date` 模式下,传 `include_nearby=true` 可以额外返回该日期前后最近的节日;返回数量由 `nearby_limit` 控制,默认 7,最大 30。
183
- * 查询节假日与万年历
184
- */
185
- async getMiscHolidayCalendarRaw(requestParameters, initOverrides) {
186
- const requestOptions = await this.getMiscHolidayCalendarRequestOpts(requestParameters);
187
- const response = await this.request(requestOptions, initOverrides);
159
+ }, initOverrides);
188
160
  return new runtime.JSONApiResponse(response, (jsonValue) => GetMiscHolidayCalendar200ResponseFromJSON(jsonValue));
189
161
  }
190
162
  /**
@@ -196,9 +168,10 @@ export class MiscApi extends runtime.BaseAPI {
196
168
  return await response.value();
197
169
  }
198
170
  /**
199
- * Creates request options for getMiscHotboard without sending the request
171
+ * 想快速跟上网络热点?这个接口让你一网打尽各大主流平台的实时热榜/热搜! ## 功能概述 你只需要指定一个平台类型,就能获取到该平台当前的热榜数据列表。每个热榜条目都包含标题、热度值和原始链接。非常适合用于制作信息聚合类应用或看板。 ## 三种使用模式 ### 默认模式 只传 `type` 参数,返回该平台当前的实时热榜。 ### 时光机模式 传 `type` + `time` 参数,返回最接近指定时间的热榜快照。如果不可用或无数据,会返回空。 ### 搜索模式 传 `type` + `keyword` + `time_start` + `time_end` 参数,在指定时间范围内搜索包含关键词的热榜条目。可选传 `limit` 限制返回数量。 ### 数据源列表 传 `sources=true`,返回所有支持历史数据的平台列表。
172
+ * 查询热榜
200
173
  */
201
- async getMiscHotboardRequestOpts(requestParameters) {
174
+ async getMiscHotboardRaw(requestParameters, initOverrides) {
202
175
  if (requestParameters['type'] == null) {
203
176
  throw new runtime.RequiredError('type', 'Required parameter "type" was null or undefined when calling getMiscHotboard().');
204
177
  }
@@ -226,20 +199,12 @@ export class MiscApi extends runtime.BaseAPI {
226
199
  }
227
200
  const headerParameters = {};
228
201
  let urlPath = `/misc/hotboard`;
229
- return {
202
+ const response = await this.request({
230
203
  path: urlPath,
231
204
  method: 'GET',
232
205
  headers: headerParameters,
233
206
  query: queryParameters,
234
- };
235
- }
236
- /**
237
- * 想快速跟上网络热点?这个接口让你一网打尽各大主流平台的实时热榜/热搜! ## 功能概述 你只需要指定一个平台类型,就能获取到该平台当前的热榜数据列表。每个热榜条目都包含标题、热度值和原始链接。非常适合用于制作信息聚合类应用或看板。 ## 三种使用模式 ### 默认模式 只传 `type` 参数,返回该平台当前的实时热榜。 ### 时光机模式 传 `type` + `time` 参数,返回最接近指定时间的热榜快照。如果不可用或无数据,会返回空。 ### 搜索模式 传 `type` + `keyword` + `time_start` + `time_end` 参数,在指定时间范围内搜索包含关键词的热榜条目。可选传 `limit` 限制返回数量。 ### 数据源列表 传 `sources=true`,返回所有支持历史数据的平台列表。
238
- * 查询热榜
239
- */
240
- async getMiscHotboardRaw(requestParameters, initOverrides) {
241
- const requestOptions = await this.getMiscHotboardRequestOpts(requestParameters);
242
- const response = await this.request(requestOptions, initOverrides);
207
+ }, initOverrides);
243
208
  return new runtime.JSONApiResponse(response, (jsonValue) => GetMiscHotboard200ResponseFromJSON(jsonValue));
244
209
  }
245
210
  /**
@@ -251,9 +216,10 @@ export class MiscApi extends runtime.BaseAPI {
251
216
  return await response.value();
252
217
  }
253
218
  /**
254
- * Creates request options for getMiscLunartime without sending the request
219
+ * 需要在指定时区下查看某个时间点的农历信息?这个接口可以直接返回完整结果。 ## 功能概述 支持传入 Unix 时间戳(秒或毫秒)和 IANA 时区名,返回公历时间、星期、农历年月日、干支、生肖、节气与节日信息。不传 `ts` 时默认使用当前时间,不传 `timezone` 时默认 `Asia/Shanghai`。 ## 时区说明 - 支持标准 IANA 时区,例如 `Asia/Shanghai`、`Asia/Tokyo` - 也支持别名:`Shanghai`、`Beijing` - 时区非法时返回 400 并提示 `invalid timezone: xxx`
220
+ * 查询农历时间
255
221
  */
256
- async getMiscLunartimeRequestOpts(requestParameters) {
222
+ async getMiscLunartimeRaw(requestParameters, initOverrides) {
257
223
  const queryParameters = {};
258
224
  if (requestParameters['ts'] != null) {
259
225
  queryParameters['ts'] = requestParameters['ts'];
@@ -263,20 +229,12 @@ export class MiscApi extends runtime.BaseAPI {
263
229
  }
264
230
  const headerParameters = {};
265
231
  let urlPath = `/misc/lunartime`;
266
- return {
232
+ const response = await this.request({
267
233
  path: urlPath,
268
234
  method: 'GET',
269
235
  headers: headerParameters,
270
236
  query: queryParameters,
271
- };
272
- }
273
- /**
274
- * 需要在指定时区下查看某个时间点的农历信息?这个接口可以直接返回完整结果。 ## 功能概述 支持传入 Unix 时间戳(秒或毫秒)和 IANA 时区名,返回公历时间、星期、农历年月日、干支、生肖、节气与节日信息。不传 `ts` 时默认使用当前时间,不传 `timezone` 时默认 `Asia/Shanghai`。 ## 时区说明 - 支持标准 IANA 时区,例如 `Asia/Shanghai`、`Asia/Tokyo` - 也支持别名:`Shanghai`、`Beijing` - 时区非法时返回 400 并提示 `invalid timezone: xxx`
275
- * 查询农历时间
276
- */
277
- async getMiscLunartimeRaw(requestParameters, initOverrides) {
278
- const requestOptions = await this.getMiscLunartimeRequestOpts(requestParameters);
279
- const response = await this.request(requestOptions, initOverrides);
237
+ }, initOverrides);
280
238
  return new runtime.JSONApiResponse(response, (jsonValue) => GetMiscLunartime200ResponseFromJSON(jsonValue));
281
239
  }
282
240
  /**
@@ -288,9 +246,10 @@ export class MiscApi extends runtime.BaseAPI {
288
246
  return await response.value();
289
247
  }
290
248
  /**
291
- * Creates request options for getMiscPhoneinfo without sending the request
249
+ * 想知道一个手机号码来自哪里?是移动、联通还是电信?这个接口可以告诉你答案。 ## 功能概述 提供一个国内的手机号码,我们会查询并返回它的归属地(省份和城市)以及所属的运营商信息。
250
+ * 查询手机归属地
292
251
  */
293
- async getMiscPhoneinfoRequestOpts(requestParameters) {
252
+ async getMiscPhoneinfoRaw(requestParameters, initOverrides) {
294
253
  if (requestParameters['phone'] == null) {
295
254
  throw new runtime.RequiredError('phone', 'Required parameter "phone" was null or undefined when calling getMiscPhoneinfo().');
296
255
  }
@@ -300,20 +259,12 @@ export class MiscApi extends runtime.BaseAPI {
300
259
  }
301
260
  const headerParameters = {};
302
261
  let urlPath = `/misc/phoneinfo`;
303
- return {
262
+ const response = await this.request({
304
263
  path: urlPath,
305
264
  method: 'GET',
306
265
  headers: headerParameters,
307
266
  query: queryParameters,
308
- };
309
- }
310
- /**
311
- * 想知道一个手机号码来自哪里?是移动、联通还是电信?这个接口可以告诉你答案。 ## 功能概述 提供一个国内的手机号码,我们会查询并返回它的归属地(省份和城市)以及所属的运营商信息。
312
- * 查询手机归属地
313
- */
314
- async getMiscPhoneinfoRaw(requestParameters, initOverrides) {
315
- const requestOptions = await this.getMiscPhoneinfoRequestOpts(requestParameters);
316
- const response = await this.request(requestOptions, initOverrides);
267
+ }, initOverrides);
317
268
  return new runtime.JSONApiResponse(response, (jsonValue) => GetMiscPhoneinfo200ResponseFromJSON(jsonValue));
318
269
  }
319
270
  /**
@@ -325,9 +276,10 @@ export class MiscApi extends runtime.BaseAPI {
325
276
  return await response.value();
326
277
  }
327
278
  /**
328
- * Creates request options for getMiscRandomnumber without sending the request
279
+ * 需要一个简单的随机数,还是需要一串不重复的、带小数的随机数?这个接口都能满足你! ## 功能概述 这是一个强大的随机数生成器。你可以指定生成的范围(最大/最小值)、数量、是否允许重复、以及是否生成小数(并指定小数位数)。 ## 流程图 ```mermaid graph TD A[开始] --> B{参数校验}; B --> |通过| C{是否允许小数?}; C --> |是| D[生成随机小数]; C --> |否| E[生成随机整数]; D --> F{是否允许重复?}; E --> F; F --> |是| G[直接生成指定数量]; F --> |否| H[生成不重复的数字]; G --> I[返回结果]; H --> I; B --> |失败| J[返回 400 错误]; ``` ## 使用须知 > [!WARNING] > **不重复生成的逻辑限制** > 当设置 `allow_repeat=false` 时,请确保取值范围 `(max - min + 1)` 大于或等于你请求的数量 `count`。否则,系统将无法生成足够的不重复数字,请求会失败并返回 400 错误。
280
+ * 随机数生成
329
281
  */
330
- async getMiscRandomnumberRequestOpts(requestParameters) {
282
+ async getMiscRandomnumberRaw(requestParameters, initOverrides) {
331
283
  const queryParameters = {};
332
284
  if (requestParameters['min'] != null) {
333
285
  queryParameters['min'] = requestParameters['min'];
@@ -349,20 +301,12 @@ export class MiscApi extends runtime.BaseAPI {
349
301
  }
350
302
  const headerParameters = {};
351
303
  let urlPath = `/misc/randomnumber`;
352
- return {
304
+ const response = await this.request({
353
305
  path: urlPath,
354
306
  method: 'GET',
355
307
  headers: headerParameters,
356
308
  query: queryParameters,
357
- };
358
- }
359
- /**
360
- * 需要一个简单的随机数,还是需要一串不重复的、带小数的随机数?这个接口都能满足你! ## 功能概述 这是一个强大的随机数生成器。你可以指定生成的范围(最大/最小值)、数量、是否允许重复、以及是否生成小数(并指定小数位数)。 ## 流程图 ```mermaid graph TD A[开始] --> B{参数校验}; B --> |通过| C{是否允许小数?}; C --> |是| D[生成随机小数]; C --> |否| E[生成随机整数]; D --> F{是否允许重复?}; E --> F; F --> |是| G[直接生成指定数量]; F --> |否| H[生成不重复的数字]; G --> I[返回结果]; H --> I; B --> |失败| J[返回 400 错误]; ``` ## 使用须知 > [!WARNING] > **不重复生成的逻辑限制** > 当设置 `allow_repeat=false` 时,请确保取值范围 `(max - min + 1)` 大于或等于你请求的数量 `count`。否则,系统将无法生成足够的不重复数字,请求会失败并返回 400 错误。
361
- * 随机数生成
362
- */
363
- async getMiscRandomnumberRaw(requestParameters, initOverrides) {
364
- const requestOptions = await this.getMiscRandomnumberRequestOpts(requestParameters);
365
- const response = await this.request(requestOptions, initOverrides);
309
+ }, initOverrides);
366
310
  return new runtime.JSONApiResponse(response, (jsonValue) => GetMiscRandomnumber200ResponseFromJSON(jsonValue));
367
311
  }
368
312
  /**
@@ -374,9 +318,10 @@ export class MiscApi extends runtime.BaseAPI {
374
318
  return await response.value();
375
319
  }
376
320
  /**
377
- * Creates request options for getMiscTimestamp without sending the request
321
+ * 这是一个用于将Unix时间戳转换为人类可读日期时间的旧版接口。 ## 功能概述 输入一个秒级或毫秒级的时间戳,返回其对应的本地时间和UTC时间。 > [!WARNING] > **接口已过时**:这个接口已被新的 `/convert/unixtime` 取代。新接口功能更强大,支持双向转换。我们建议你迁移到新接口。 [➡️ 前往新版接口文档](/docs/api-reference/get-convert-unixtime)
322
+ * 转换时间戳 (旧版,推荐使用/convert/unixtime)
378
323
  */
379
- async getMiscTimestampRequestOpts(requestParameters) {
324
+ async getMiscTimestampRaw(requestParameters, initOverrides) {
380
325
  if (requestParameters['ts'] == null) {
381
326
  throw new runtime.RequiredError('ts', 'Required parameter "ts" was null or undefined when calling getMiscTimestamp().');
382
327
  }
@@ -386,20 +331,12 @@ export class MiscApi extends runtime.BaseAPI {
386
331
  }
387
332
  const headerParameters = {};
388
333
  let urlPath = `/misc/timestamp`;
389
- return {
334
+ const response = await this.request({
390
335
  path: urlPath,
391
336
  method: 'GET',
392
337
  headers: headerParameters,
393
338
  query: queryParameters,
394
- };
395
- }
396
- /**
397
- * 这是一个用于将Unix时间戳转换为人类可读日期时间的旧版接口。 ## 功能概述 输入一个秒级或毫秒级的时间戳,返回其对应的本地时间和UTC时间。 > [!WARNING] > **接口已过时**:这个接口已被新的 `/convert/unixtime` 取代。新接口功能更强大,支持双向转换。我们建议你迁移到新接口。 [➡️ 前往新版接口文档](/docs/api-reference/get-convert-unixtime)
398
- * 转换时间戳 (旧版,推荐使用/convert/unixtime)
399
- */
400
- async getMiscTimestampRaw(requestParameters, initOverrides) {
401
- const requestOptions = await this.getMiscTimestampRequestOpts(requestParameters);
402
- const response = await this.request(requestOptions, initOverrides);
339
+ }, initOverrides);
403
340
  return new runtime.JSONApiResponse(response, (jsonValue) => GetMiscTimestamp200ResponseFromJSON(jsonValue));
404
341
  }
405
342
  /**
@@ -411,26 +348,19 @@ export class MiscApi extends runtime.BaseAPI {
411
348
  return await response.value();
412
349
  }
413
350
  /**
414
- * Creates request options for getMiscTrackingCarriers without sending the request
351
+ * 不确定系统支持哪些快递公司?这个接口返回完整的支持列表。 ## 功能概述 获取系统当前支持的所有快递公司列表,包括每家公司的标准编码(code)和中文名称(name)。 ## 使用建议 - **推荐缓存**:这个列表基本不会频繁变动,建议在应用启动时调用一次并缓存到本地 - **应用场景**:适合用于构建快递公司选择器、下拉菜单等UI组件 - **缓存时长**:建议缓存24小时或更久
352
+ * 获取支持的快递公司列表
415
353
  */
416
- async getMiscTrackingCarriersRequestOpts() {
354
+ async getMiscTrackingCarriersRaw(initOverrides) {
417
355
  const queryParameters = {};
418
356
  const headerParameters = {};
419
357
  let urlPath = `/misc/tracking/carriers`;
420
- return {
358
+ const response = await this.request({
421
359
  path: urlPath,
422
360
  method: 'GET',
423
361
  headers: headerParameters,
424
362
  query: queryParameters,
425
- };
426
- }
427
- /**
428
- * 不确定系统支持哪些快递公司?这个接口返回完整的支持列表。 ## 功能概述 获取系统当前支持的所有快递公司列表,包括每家公司的标准编码(code)和中文名称(name)。 ## 使用建议 - **推荐缓存**:这个列表基本不会频繁变动,建议在应用启动时调用一次并缓存到本地 - **应用场景**:适合用于构建快递公司选择器、下拉菜单等UI组件 - **缓存时长**:建议缓存24小时或更久
429
- * 获取支持的快递公司列表
430
- */
431
- async getMiscTrackingCarriersRaw(initOverrides) {
432
- const requestOptions = await this.getMiscTrackingCarriersRequestOpts();
433
- const response = await this.request(requestOptions, initOverrides);
363
+ }, initOverrides);
434
364
  return new runtime.JSONApiResponse(response, (jsonValue) => GetMiscTrackingCarriers200ResponseFromJSON(jsonValue));
435
365
  }
436
366
  /**
@@ -442,9 +372,10 @@ export class MiscApi extends runtime.BaseAPI {
442
372
  return await response.value();
443
373
  }
444
374
  /**
445
- * Creates request options for getMiscTrackingDetect without sending the request
375
+ * 不确定手里的快递单号属于哪家快递公司?这个接口专门做识别,不查物流。 ## 功能概述 输入快递单号,系统会根据单号规则快速识别出最可能的快递公司。如果存在多个可能的匹配结果,还会在 `alternatives` 字段中返回备选项,供你参考选择。 ## 使用须知 - **识别速度快**:只做规则匹配,不查询物流信息,响应速度通常在100ms内 - **准确率高**:基于各快递公司的单号规则进行智能识别,准确率超过95% - **备选方案**:当单号规则可能匹配多家快递公司时,会提供所有可能的选项
376
+ * 识别快递公司
446
377
  */
447
- async getMiscTrackingDetectRequestOpts(requestParameters) {
378
+ async getMiscTrackingDetectRaw(requestParameters, initOverrides) {
448
379
  if (requestParameters['trackingNumber'] == null) {
449
380
  throw new runtime.RequiredError('trackingNumber', 'Required parameter "trackingNumber" was null or undefined when calling getMiscTrackingDetect().');
450
381
  }
@@ -454,20 +385,12 @@ export class MiscApi extends runtime.BaseAPI {
454
385
  }
455
386
  const headerParameters = {};
456
387
  let urlPath = `/misc/tracking/detect`;
457
- return {
388
+ const response = await this.request({
458
389
  path: urlPath,
459
390
  method: 'GET',
460
391
  headers: headerParameters,
461
392
  query: queryParameters,
462
- };
463
- }
464
- /**
465
- * 不确定手里的快递单号属于哪家快递公司?这个接口专门做识别,不查物流。 ## 功能概述 输入快递单号,系统会根据单号规则快速识别出最可能的快递公司。如果存在多个可能的匹配结果,还会在 `alternatives` 字段中返回备选项,供你参考选择。 ## 使用须知 - **识别速度快**:只做规则匹配,不查询物流信息,响应速度通常在100ms内 - **准确率高**:基于各快递公司的单号规则进行智能识别,准确率超过95% - **备选方案**:当单号规则可能匹配多家快递公司时,会提供所有可能的选项
466
- * 识别快递公司
467
- */
468
- async getMiscTrackingDetectRaw(requestParameters, initOverrides) {
469
- const requestOptions = await this.getMiscTrackingDetectRequestOpts(requestParameters);
470
- const response = await this.request(requestOptions, initOverrides);
393
+ }, initOverrides);
471
394
  return new runtime.JSONApiResponse(response, (jsonValue) => GetMiscTrackingDetect200ResponseFromJSON(jsonValue));
472
395
  }
473
396
  /**
@@ -479,9 +402,10 @@ export class MiscApi extends runtime.BaseAPI {
479
402
  return await response.value();
480
403
  }
481
404
  /**
482
- * Creates request options for getMiscTrackingQuery without sending the request
405
+ * 买了东西想知道快递到哪儿了?这个接口帮你实时追踪物流状态。 ## 功能概述 提供一个快递单号,系统会自动识别快递公司并返回完整的物流轨迹信息。这个接口目前可以查询中通、圆通、韵达、申通、极兔、京东、EMS、德邦等主流快递公司的物流信息。 ## 使用须知 目前暂不支持顺丰快递单号的物流查询。 - **自动识别**:不知道是哪家快递?系统会根据单号规则自动识别快递公司(推荐使用) - **手动指定**:如果已知快递公司,可以传递 `carrier_code` 参数,查询速度会更快 - **手机尾号验证**:部分快递公司需要验证收件人手机尾号才能查询详细物流,如果返回 `暂无物流信息`,建议尝试传入 `phone` 参数 - **查询时效**:物流信息实时查询,响应时间通常在1-2秒内
406
+ * 查询快递物流信息
483
407
  */
484
- async getMiscTrackingQueryRequestOpts(requestParameters) {
408
+ async getMiscTrackingQueryRaw(requestParameters, initOverrides) {
485
409
  if (requestParameters['trackingNumber'] == null) {
486
410
  throw new runtime.RequiredError('trackingNumber', 'Required parameter "trackingNumber" was null or undefined when calling getMiscTrackingQuery().');
487
411
  }
@@ -497,20 +421,12 @@ export class MiscApi extends runtime.BaseAPI {
497
421
  }
498
422
  const headerParameters = {};
499
423
  let urlPath = `/misc/tracking/query`;
500
- return {
424
+ const response = await this.request({
501
425
  path: urlPath,
502
426
  method: 'GET',
503
427
  headers: headerParameters,
504
428
  query: queryParameters,
505
- };
506
- }
507
- /**
508
- * 买了东西想知道快递到哪儿了?这个接口帮你实时追踪物流状态。 ## 功能概述 提供一个快递单号,系统会自动识别快递公司并返回完整的物流轨迹信息。这个接口目前可以查询中通、圆通、韵达、申通、极兔、京东、EMS、德邦等主流快递公司的物流信息。 ## 使用须知 目前暂不支持顺丰快递单号的物流查询。 - **自动识别**:不知道是哪家快递?系统会根据单号规则自动识别快递公司(推荐使用) - **手动指定**:如果已知快递公司,可以传递 `carrier_code` 参数,查询速度会更快 - **手机尾号验证**:部分快递公司需要验证收件人手机尾号才能查询详细物流,如果返回 `暂无物流信息`,建议尝试传入 `phone` 参数 - **查询时效**:物流信息实时查询,响应时间通常在1-2秒内
509
- * 查询快递物流信息
510
- */
511
- async getMiscTrackingQueryRaw(requestParameters, initOverrides) {
512
- const requestOptions = await this.getMiscTrackingQueryRequestOpts(requestParameters);
513
- const response = await this.request(requestOptions, initOverrides);
429
+ }, initOverrides);
514
430
  return new runtime.JSONApiResponse(response, (jsonValue) => GetMiscTrackingQuery200ResponseFromJSON(jsonValue));
515
431
  }
516
432
  /**
@@ -522,9 +438,10 @@ export class MiscApi extends runtime.BaseAPI {
522
438
  return await response.value();
523
439
  }
524
440
  /**
525
- * Creates request options for getMiscWeather without sending the request
441
+ * 出门前,查一下天气总是个好习惯。这个接口为你提供精准、实时的天气数据,支持国内和国际城市。 ## 功能概述 这个接口支持三种查询方式: - 可以传 `adcode`,按行政区编码查询(优先级最高) - 可以传 `city`,按城市名称查询,支持中文(`北京`)和英文(`Tokyo`) - 两个都不传时,按客户端 IP 自动定位查询 支持 `lang` 参数,可选 `zh`(默认)和 `en`,城市名翻译覆盖 7000+ 城市。 ## 可选功能模块 - `extended=true`:扩展气象字段(体感温度、能见度、气压、紫外线、空气质量及污染物分项数据) - `forecast=true`:多天预报(最多7天,会额外返回每天的最高温度、最低温度,以及日出日落、风速等详细数据) - `hourly=true`:逐小时预报(24小时) - `minutely=true`:分钟级降水预报(仅国内城市,精确到2分钟) - `indices=true`:18项生活指数(穿衣、紫外线、洗车、运动、花粉等) ## 天气字段说明 `weather` 是天气现象文本,不是固定枚举。 常见值包括:晴、多云、阴、小雨、中雨、大雨、雷阵雨、小雪、中雪、大雪、雨夹雪、雾、霾、沙尘。 如果你的业务需要稳定的天气分类,建议使用 `weather_code` 进行映射。完整的天气图标代码请参考[天气图标代码表](#enum-list)。
442
+ * 查询天气
526
443
  */
527
- async getMiscWeatherRequestOpts(requestParameters) {
444
+ async getMiscWeatherRaw(requestParameters, initOverrides) {
528
445
  const queryParameters = {};
529
446
  if (requestParameters['city'] != null) {
530
447
  queryParameters['city'] = requestParameters['city'];
@@ -552,20 +469,12 @@ export class MiscApi extends runtime.BaseAPI {
552
469
  }
553
470
  const headerParameters = {};
554
471
  let urlPath = `/misc/weather`;
555
- return {
472
+ const response = await this.request({
556
473
  path: urlPath,
557
474
  method: 'GET',
558
475
  headers: headerParameters,
559
476
  query: queryParameters,
560
- };
561
- }
562
- /**
563
- * 出门前,查一下天气总是个好习惯。这个接口为你提供精准、实时的天气数据,支持国内和国际城市。 ## 功能概述 这个接口支持三种查询方式: - 可以传 `adcode`,按行政区编码查询(优先级最高) - 可以传 `city`,按城市名称查询,支持中文(`北京`)和英文(`Tokyo`) - 两个都不传时,按客户端 IP 自动定位查询 支持 `lang` 参数,可选 `zh`(默认)和 `en`,城市名翻译覆盖 7000+ 城市。 ## 可选功能模块 - `extended=true`:扩展气象字段(体感温度、能见度、气压、紫外线、空气质量及污染物分项数据) - `forecast=true`:多天预报(最多7天,会额外返回每天的最高温度、最低温度,以及日出日落、风速等详细数据) - `hourly=true`:逐小时预报(24小时) - `minutely=true`:分钟级降水预报(仅国内城市,精确到2分钟) - `indices=true`:18项生活指数(穿衣、紫外线、洗车、运动、花粉等) ## 天气字段说明 `weather` 是天气现象文本,不是固定枚举。 常见值包括:晴、多云、阴、小雨、中雨、大雨、雷阵雨、小雪、中雪、大雪、雨夹雪、雾、霾、沙尘。 如果你的业务需要稳定的天气分类,建议使用 `weather_code` 进行映射。完整的天气图标代码请参考[天气图标代码表](#enum-list)。
564
- * 查询天气
565
- */
566
- async getMiscWeatherRaw(requestParameters, initOverrides) {
567
- const requestOptions = await this.getMiscWeatherRequestOpts(requestParameters);
568
- const response = await this.request(requestOptions, initOverrides);
477
+ }, initOverrides);
569
478
  return new runtime.JSONApiResponse(response, (jsonValue) => GetMiscWeather200ResponseFromJSON(jsonValue));
570
479
  }
571
480
  /**
@@ -577,9 +486,10 @@ export class MiscApi extends runtime.BaseAPI {
577
486
  return await response.value();
578
487
  }
579
488
  /**
580
- * Creates request options for getMiscWorldtime without sending the request
489
+ * 需要和国外的朋友开会,想知道他那边现在几点?用这个接口一查便知。 ## 功能概述 根据标准的时区名称(例如 \'Asia/Shanghai\' \'Europe/London\'),获取该时区的当前准确时间、UTC偏移量、星期等信息。
490
+ * 查询世界时间
581
491
  */
582
- async getMiscWorldtimeRequestOpts(requestParameters) {
492
+ async getMiscWorldtimeRaw(requestParameters, initOverrides) {
583
493
  if (requestParameters['city'] == null) {
584
494
  throw new runtime.RequiredError('city', 'Required parameter "city" was null or undefined when calling getMiscWorldtime().');
585
495
  }
@@ -589,20 +499,12 @@ export class MiscApi extends runtime.BaseAPI {
589
499
  }
590
500
  const headerParameters = {};
591
501
  let urlPath = `/misc/worldtime`;
592
- return {
502
+ const response = await this.request({
593
503
  path: urlPath,
594
504
  method: 'GET',
595
505
  headers: headerParameters,
596
506
  query: queryParameters,
597
- };
598
- }
599
- /**
600
- * 需要和国外的朋友开会,想知道他那边现在几点?用这个接口一查便知。 ## 功能概述 根据标准的时区名称(例如 \'Asia/Shanghai\' 或 \'Europe/London\'),获取该时区的当前准确时间、UTC偏移量、星期等信息。
601
- * 查询世界时间
602
- */
603
- async getMiscWorldtimeRaw(requestParameters, initOverrides) {
604
- const requestOptions = await this.getMiscWorldtimeRequestOpts(requestParameters);
605
- const response = await this.request(requestOptions, initOverrides);
507
+ }, initOverrides);
606
508
  return new runtime.JSONApiResponse(response, (jsonValue) => GetMiscWorldtime200ResponseFromJSON(jsonValue));
607
509
  }
608
510
  /**
@@ -614,9 +516,10 @@ export class MiscApi extends runtime.BaseAPI {
614
516
  return await response.value();
615
517
  }
616
518
  /**
617
- * Creates request options for postMiscDateDiff without sending the request
519
+ * 想知道两个日期之间相差多久?这个接口帮你精确计算时间差值。 ## 功能概述 输入开始日期和结束日期,返回它们之间的时间差,包括总天数、总小时数、总分钟数、总秒数、总周数,以及人性化显示格式(如\"1年2月3天\")。 ## 日期格式 接口支持自动识别常见日期格式,包括:YYYY-MM-DD、YYYY/MM/DD、DD-MM-YYYY、ISO 8601(带时区)等。也可以通过`format`参数显式指定格式(如DD-MM-YYYY)。 > [!NOTE] > 当结束日期早于开始日期时,返回的数值为负数。
520
+ * 计算两个日期之间的时间差值
618
521
  */
619
- async postMiscDateDiffRequestOpts(requestParameters) {
522
+ async postMiscDateDiffRaw(requestParameters, initOverrides) {
620
523
  if (requestParameters['postMiscDateDiffRequest'] == null) {
621
524
  throw new runtime.RequiredError('postMiscDateDiffRequest', 'Required parameter "postMiscDateDiffRequest" was null or undefined when calling postMiscDateDiff().');
622
525
  }
@@ -624,21 +527,13 @@ export class MiscApi extends runtime.BaseAPI {
624
527
  const headerParameters = {};
625
528
  headerParameters['Content-Type'] = 'application/json';
626
529
  let urlPath = `/misc/date-diff`;
627
- return {
530
+ const response = await this.request({
628
531
  path: urlPath,
629
532
  method: 'POST',
630
533
  headers: headerParameters,
631
534
  query: queryParameters,
632
535
  body: PostMiscDateDiffRequestToJSON(requestParameters['postMiscDateDiffRequest']),
633
- };
634
- }
635
- /**
636
- * 想知道两个日期之间相差多久?这个接口帮你精确计算时间差值。 ## 功能概述 输入开始日期和结束日期,返回它们之间的时间差,包括总天数、总小时数、总分钟数、总秒数、总周数,以及人性化显示格式(如\"1年2月3天\")。 ## 日期格式 接口支持自动识别常见日期格式,包括:YYYY-MM-DD、YYYY/MM/DD、DD-MM-YYYY、ISO 8601(带时区)等。也可以通过`format`参数显式指定格式(如DD-MM-YYYY)。 > [!NOTE] > 当结束日期早于开始日期时,返回的数值为负数。
637
- * 计算两个日期之间的时间差值
638
- */
639
- async postMiscDateDiffRaw(requestParameters, initOverrides) {
640
- const requestOptions = await this.postMiscDateDiffRequestOpts(requestParameters);
641
- const response = await this.request(requestOptions, initOverrides);
536
+ }, initOverrides);
642
537
  return new runtime.JSONApiResponse(response, (jsonValue) => PostMiscDateDiff200ResponseFromJSON(jsonValue));
643
538
  }
644
539
  /**