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
@@ -89,9 +89,10 @@ export interface PostSensitiveWordQuickCheckOperationRequest {
89
89
  export class DefaultApi extends runtime.BaseAPI {
90
90
 
91
91
  /**
92
- * Creates request options for getSearchEngines without sending the request
92
+ * 获取 UAPI Pro Search 引擎的详细信息,包括支持的功能特性、参数限制和使用说明。 ## 功能概述 此接口返回搜索引擎的完整配置信息,你可以用它来: - 了解搜索引擎支持哪些功能(如站内搜索、文件类型过滤等) - 获取参数的默认值和限制范围 - 查看当前引擎版本和可用状态 适合在应用初始化时调用,或用于动态配置搜索界面。
93
+ * 搜索引擎配置
93
94
  */
94
- async getSearchEnginesRequestOpts(): Promise<runtime.RequestOpts> {
95
+ async getSearchEnginesRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetSearchEngines200Response>> {
95
96
  const queryParameters: any = {};
96
97
 
97
98
  const headerParameters: runtime.HTTPHeaders = {};
@@ -99,21 +100,12 @@ export class DefaultApi extends runtime.BaseAPI {
99
100
 
100
101
  let urlPath = `/search/engines`;
101
102
 
102
- return {
103
+ const response = await this.request({
103
104
  path: urlPath,
104
105
  method: 'GET',
105
106
  headers: headerParameters,
106
107
  query: queryParameters,
107
- };
108
- }
109
-
110
- /**
111
- * 获取 UAPI Pro Search 引擎的详细信息,包括支持的功能特性、参数限制和使用说明。 ## 功能概述 此接口返回搜索引擎的完整配置信息,你可以用它来: - 了解搜索引擎支持哪些功能(如站内搜索、文件类型过滤等) - 获取参数的默认值和限制范围 - 查看当前引擎版本和可用状态 适合在应用初始化时调用,或用于动态配置搜索界面。
112
- * 搜索引擎配置
113
- */
114
- async getSearchEnginesRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetSearchEngines200Response>> {
115
- const requestOptions = await this.getSearchEnginesRequestOpts();
116
- const response = await this.request(requestOptions, initOverrides);
108
+ }, initOverrides);
117
109
 
118
110
  return new runtime.JSONApiResponse(response, (jsonValue) => GetSearchEngines200ResponseFromJSON(jsonValue));
119
111
  }
@@ -128,9 +120,10 @@ export class DefaultApi extends runtime.BaseAPI {
128
120
  }
129
121
 
130
122
  /**
131
- * Creates request options for getSensitiveWordAnalyzeQuery without sending the request
123
+ * 通过URL查询参数分析单个关键词,便于GET请求调用。
124
+ * 敏感词分析 (GET)
132
125
  */
133
- async getSensitiveWordAnalyzeQueryRequestOpts(requestParameters: GetSensitiveWordAnalyzeQueryRequest): Promise<runtime.RequestOpts> {
126
+ async getSensitiveWordAnalyzeQueryRaw(requestParameters: GetSensitiveWordAnalyzeQueryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PostSensitiveWordAnalyze200Response>> {
134
127
  if (requestParameters['keyword'] == null) {
135
128
  throw new runtime.RequiredError(
136
129
  'keyword',
@@ -149,21 +142,12 @@ export class DefaultApi extends runtime.BaseAPI {
149
142
 
150
143
  let urlPath = `/sensitive-word/analyze-query`;
151
144
 
152
- return {
145
+ const response = await this.request({
153
146
  path: urlPath,
154
147
  method: 'GET',
155
148
  headers: headerParameters,
156
149
  query: queryParameters,
157
- };
158
- }
159
-
160
- /**
161
- * 通过URL查询参数分析单个关键词,便于GET请求调用。
162
- * 敏感词分析 (GET)
163
- */
164
- async getSensitiveWordAnalyzeQueryRaw(requestParameters: GetSensitiveWordAnalyzeQueryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PostSensitiveWordAnalyze200Response>> {
165
- const requestOptions = await this.getSensitiveWordAnalyzeQueryRequestOpts(requestParameters);
166
- const response = await this.request(requestOptions, initOverrides);
150
+ }, initOverrides);
167
151
 
168
152
  return new runtime.JSONApiResponse(response, (jsonValue) => PostSensitiveWordAnalyze200ResponseFromJSON(jsonValue));
169
153
  }
@@ -178,9 +162,10 @@ export class DefaultApi extends runtime.BaseAPI {
178
162
  }
179
163
 
180
164
  /**
181
- * Creates request options for postSearchAggregate without sending the request
165
+ * 想在你的应用中集成搜索功能?我们提供了一个强大的搜索引擎API,让你可以轻松实现实时网页搜索。 ## 功能概述 UAPI Pro Search 是一个智能搜索引擎,采用机器学习算法对搜索结果进行智能排序,确保最相关的内容排在前面。你可以用它搜索任何关键词,也可以限定在特定网站或特定文件类型中搜索。 - **实时网页搜索**: 毫秒级响应,快速返回搜索结果 - **智能排序**: 采用机器学习回归排序算法,结果更精准 - **时间排序**: 支持按发布时间排序,获取最新内容 - **时间范围过滤**: 支持按天/周/月/年过滤结果 - **站内搜索**: 支持 `site:` 操作符,在指定网站内搜索 - **文件类型过滤**: 支持 `filetype:` 操作符,快速找到 PDF、Word 等特定格式文件
166
+ * 智能搜索
182
167
  */
183
- async postSearchAggregateRequestOpts(requestParameters: PostSearchAggregateOperationRequest): Promise<runtime.RequestOpts> {
168
+ async postSearchAggregateRaw(requestParameters: PostSearchAggregateOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PostSearchAggregate200Response>> {
184
169
  if (requestParameters['postSearchAggregateRequest'] == null) {
185
170
  throw new runtime.RequiredError(
186
171
  'postSearchAggregateRequest',
@@ -197,22 +182,13 @@ export class DefaultApi extends runtime.BaseAPI {
197
182
 
198
183
  let urlPath = `/search/aggregate`;
199
184
 
200
- return {
185
+ const response = await this.request({
201
186
  path: urlPath,
202
187
  method: 'POST',
203
188
  headers: headerParameters,
204
189
  query: queryParameters,
205
190
  body: PostSearchAggregateRequestToJSON(requestParameters['postSearchAggregateRequest']),
206
- };
207
- }
208
-
209
- /**
210
- * 想在你的应用中集成搜索功能?我们提供了一个强大的搜索引擎API,让你可以轻松实现实时网页搜索。 ## 功能概述 UAPI Pro Search 是一个智能搜索引擎,采用机器学习算法对搜索结果进行智能排序,确保最相关的内容排在前面。你可以用它搜索任何关键词,也可以限定在特定网站或特定文件类型中搜索。 - **实时网页搜索**: 毫秒级响应,快速返回搜索结果 - **智能排序**: 采用机器学习回归排序算法,结果更精准 - **时间排序**: 支持按发布时间排序,获取最新内容 - **时间范围过滤**: 支持按天/周/月/年过滤结果 - **站内搜索**: 支持 `site:` 操作符,在指定网站内搜索 - **文件类型过滤**: 支持 `filetype:` 操作符,快速找到 PDF、Word 等特定格式文件
211
- * 智能搜索
212
- */
213
- async postSearchAggregateRaw(requestParameters: PostSearchAggregateOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PostSearchAggregate200Response>> {
214
- const requestOptions = await this.postSearchAggregateRequestOpts(requestParameters);
215
- const response = await this.request(requestOptions, initOverrides);
191
+ }, initOverrides);
216
192
 
217
193
  return new runtime.JSONApiResponse(response, (jsonValue) => PostSearchAggregate200ResponseFromJSON(jsonValue));
218
194
  }
@@ -227,9 +203,10 @@ export class DefaultApi extends runtime.BaseAPI {
227
203
  }
228
204
 
229
205
  /**
230
- * Creates request options for postSensitiveWordAnalyze without sending the request
206
+ * 分析单个或多个关键词的敏感程度,返回标准化风险标签与置信度结果。 ## 功能概述 - **模型驱动**: 使用先进的分析模型进行语义分析。 - **高性能**: 采用三级缓存策略(持久化存储 统一缓存 → 模型分析),确保高频请求的响应速度。 - **并发支持**: 支持批量并发处理,单次最多可分析100个关键词。 - **输入限制**: 单条关键词最多 1,000 字符,总字符数最多 20,000。 - **标准标签**: 返回 `label` 字段,明确区分 `sensitive` 与 `normal`。 - **分类清晰**: 返回 `category` 字段,用于标识具体风险类别。 - **置信度输出**: 返回 `confidence` 字段,范围为0.0到1.0。 ## 响应字段说明 | 字段 | 类型 | 说明 | |------|------|------| | `results` | array | 分析结果对象的数组。 | | `results[].k` | string | 您在请求中提供的原始关键词。 | | `results[].label` | string | 核心判断字段:`sensitive`(敏感)、`normal`(正常)。 | | `results[].category` | string | 风险分类:`safe`(安全)、`threat`(威胁)、`porn`(色情)、`fraud`(欺诈)、`insult`(辱骂)。 | | `results[].confidence` | number | 当前分类的置信度,范围0.0到1.0。 | | `total` | integer | 本次请求成功分析的关键词总数。 |
207
+ * 分析敏感词
231
208
  */
232
- async postSensitiveWordAnalyzeRequestOpts(requestParameters: PostSensitiveWordAnalyzeOperationRequest): Promise<runtime.RequestOpts> {
209
+ async postSensitiveWordAnalyzeRaw(requestParameters: PostSensitiveWordAnalyzeOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PostSensitiveWordAnalyze200Response>> {
233
210
  if (requestParameters['postSensitiveWordAnalyzeRequest'] == null) {
234
211
  throw new runtime.RequiredError(
235
212
  'postSensitiveWordAnalyzeRequest',
@@ -246,22 +223,13 @@ export class DefaultApi extends runtime.BaseAPI {
246
223
 
247
224
  let urlPath = `/sensitive-word/analyze`;
248
225
 
249
- return {
226
+ const response = await this.request({
250
227
  path: urlPath,
251
228
  method: 'POST',
252
229
  headers: headerParameters,
253
230
  query: queryParameters,
254
231
  body: PostSensitiveWordAnalyzeRequestToJSON(requestParameters['postSensitiveWordAnalyzeRequest']),
255
- };
256
- }
257
-
258
- /**
259
- * 分析单个或多个关键词的敏感程度,返回标准化风险标签与置信度结果。 ## 功能概述 - **模型驱动**: 使用先进的分析模型进行语义分析。 - **高性能**: 采用三级缓存策略(持久化存储 → 统一缓存 → 模型分析),确保高频请求的响应速度。 - **并发支持**: 支持批量并发处理,单次最多可分析100个关键词。 - **输入限制**: 单条关键词最多 1,000 字符,总字符数最多 20,000。 - **标准标签**: 返回 `label` 字段,明确区分 `sensitive` 与 `normal`。 - **分类清晰**: 返回 `category` 字段,用于标识具体风险类别。 - **置信度输出**: 返回 `confidence` 字段,范围为0.0到1.0。 ## 响应字段说明 | 字段 | 类型 | 说明 | |------|------|------| | `results` | array | 分析结果对象的数组。 | | `results[].k` | string | 您在请求中提供的原始关键词。 | | `results[].label` | string | 核心判断字段:`sensitive`(敏感)、`normal`(正常)。 | | `results[].category` | string | 风险分类:`safe`(安全)、`threat`(威胁)、`porn`(色情)、`fraud`(欺诈)、`insult`(辱骂)。 | | `results[].confidence` | number | 当前分类的置信度,范围0.0到1.0。 | | `total` | integer | 本次请求成功分析的关键词总数。 |
260
- * 分析敏感词
261
- */
262
- async postSensitiveWordAnalyzeRaw(requestParameters: PostSensitiveWordAnalyzeOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PostSensitiveWordAnalyze200Response>> {
263
- const requestOptions = await this.postSensitiveWordAnalyzeRequestOpts(requestParameters);
264
- const response = await this.request(requestOptions, initOverrides);
232
+ }, initOverrides);
265
233
 
266
234
  return new runtime.JSONApiResponse(response, (jsonValue) => PostSensitiveWordAnalyze200ResponseFromJSON(jsonValue));
267
235
  }
@@ -276,9 +244,10 @@ export class DefaultApi extends runtime.BaseAPI {
276
244
  }
277
245
 
278
246
  /**
279
- * Creates request options for postSensitiveWordQuickCheck without sending the request
247
+ * 在你的社区或应用中,需要来过滤掉不和谐的声音吗?这个接口可以助你一臂之力。 ## 功能概述 我们对敏感词检测接口进行了大幅升级,现在采用高效的 **Aho-Corasick 算法**,实现了多模式字符串匹配。这意味着你不再需要手动编写复杂的正则表达式,系统会自动高效地检测出文本中的所有敏感词。 ### 主要特性 - **高性能算法**:基于 Aho-Corasick 算法,单次扫描即可检测多个敏感词模式 - **简繁体支持**:自动识别和处理简体中文、繁体中文内容 - **多模匹配**:无需编写正则表达式,系统内置智能匹配逻辑 - **快速响应**:相比传统方法,检测速度显著提升 无论是论坛、社交平台还是评论系统,这个接口都能帮你快速构建内容审核功能。
248
+ * 敏感词检测(快速)
280
249
  */
281
- async postSensitiveWordQuickCheckRequestOpts(requestParameters: PostSensitiveWordQuickCheckOperationRequest): Promise<runtime.RequestOpts> {
250
+ async postSensitiveWordQuickCheckRaw(requestParameters: PostSensitiveWordQuickCheckOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PostSensitiveWordQuickCheck200Response>> {
282
251
  if (requestParameters['postSensitiveWordQuickCheckRequest'] == null) {
283
252
  throw new runtime.RequiredError(
284
253
  'postSensitiveWordQuickCheckRequest',
@@ -295,22 +264,13 @@ export class DefaultApi extends runtime.BaseAPI {
295
264
 
296
265
  let urlPath = `/text/profanitycheck`;
297
266
 
298
- return {
267
+ const response = await this.request({
299
268
  path: urlPath,
300
269
  method: 'POST',
301
270
  headers: headerParameters,
302
271
  query: queryParameters,
303
272
  body: PostSensitiveWordQuickCheckRequestToJSON(requestParameters['postSensitiveWordQuickCheckRequest']),
304
- };
305
- }
306
-
307
- /**
308
- * 在你的社区或应用中,需要来过滤掉不和谐的声音吗?这个接口可以助你一臂之力。 ## 功能概述 我们对敏感词检测接口进行了大幅升级,现在采用高效的 **Aho-Corasick 算法**,实现了多模式字符串匹配。这意味着你不再需要手动编写复杂的正则表达式,系统会自动高效地检测出文本中的所有敏感词。 ### 主要特性 - **高性能算法**:基于 Aho-Corasick 算法,单次扫描即可检测多个敏感词模式 - **简繁体支持**:自动识别和处理简体中文、繁体中文内容 - **多模匹配**:无需编写正则表达式,系统内置智能匹配逻辑 - **快速响应**:相比传统方法,检测速度显著提升 无论是论坛、社交平台还是评论系统,这个接口都能帮你快速构建内容审核功能。
309
- * 敏感词检测(快速)
310
- */
311
- async postSensitiveWordQuickCheckRaw(requestParameters: PostSensitiveWordQuickCheckOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PostSensitiveWordQuickCheck200Response>> {
312
- const requestOptions = await this.postSensitiveWordQuickCheckRequestOpts(requestParameters);
313
- const response = await this.request(requestOptions, initOverrides);
273
+ }, initOverrides);
314
274
 
315
275
  return new runtime.JSONApiResponse(response, (jsonValue) => PostSensitiveWordQuickCheck200ResponseFromJSON(jsonValue));
316
276
  }
@@ -102,9 +102,10 @@ export interface GetGameSteamSummaryRequest {
102
102
  export class GameApi extends runtime.BaseAPI {
103
103
 
104
104
  /**
105
- * Creates request options for getGameEpicFree without sending the request
105
+ * 白嫖党的福音来了!想第一时间知道Epic商店本周送了哪些游戏大作吗? ## 功能概述 这个接口帮你实时追踪Epic Games商店的每周免费游戏活动。无需任何参数,调用后即可获得当前所有免费游戏的完整信息,包括游戏封面、原价、剩余时间等,再也不用担心错过心仪的免费游戏了! ## 使用场景 - 开发游戏资讯应用或网站 - 制作Epic免费游戏推送机器人 - 为用户提供游戏收藏建议 - 构建个人游戏库管理工具 > [!TIP] > **关于时间格式** > 为了方便不同场景的使用,我们同时提供了可读的时间字符串(如 `2025/01/10 00:00:00`)和13位毫秒时间戳。前端显示用字符串,程序逻辑用时间戳
106
+ * Epic 免费游戏
106
107
  */
107
- async getGameEpicFreeRequestOpts(): Promise<runtime.RequestOpts> {
108
+ async getGameEpicFreeRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetGameEpicFree200Response>> {
108
109
  const queryParameters: any = {};
109
110
 
110
111
  const headerParameters: runtime.HTTPHeaders = {};
@@ -112,21 +113,12 @@ export class GameApi extends runtime.BaseAPI {
112
113
 
113
114
  let urlPath = `/game/epic-free`;
114
115
 
115
- return {
116
+ const response = await this.request({
116
117
  path: urlPath,
117
118
  method: 'GET',
118
119
  headers: headerParameters,
119
120
  query: queryParameters,
120
- };
121
- }
122
-
123
- /**
124
- * 白嫖党的福音来了!想第一时间知道Epic商店本周送了哪些游戏大作吗? ## 功能概述 这个接口帮你实时追踪Epic Games商店的每周免费游戏活动。无需任何参数,调用后即可获得当前所有免费游戏的完整信息,包括游戏封面、原价、剩余时间等,再也不用担心错过心仪的免费游戏了! ## 使用场景 - 开发游戏资讯应用或网站 - 制作Epic免费游戏推送机器人 - 为用户提供游戏收藏建议 - 构建个人游戏库管理工具 > [!TIP] > **关于时间格式** > 为了方便不同场景的使用,我们同时提供了可读的时间字符串(如 `2025/01/10 00:00:00`)和13位毫秒时间戳。前端显示用字符串,程序逻辑用时间戳
125
- * Epic 免费游戏
126
- */
127
- async getGameEpicFreeRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetGameEpicFree200Response>> {
128
- const requestOptions = await this.getGameEpicFreeRequestOpts();
129
- const response = await this.request(requestOptions, initOverrides);
121
+ }, initOverrides);
130
122
 
131
123
  return new runtime.JSONApiResponse(response, (jsonValue) => GetGameEpicFree200ResponseFromJSON(jsonValue));
132
124
  }
@@ -141,9 +133,10 @@ export class GameApi extends runtime.BaseAPI {
141
133
  }
142
134
 
143
135
  /**
144
- * Creates request options for getGameMinecraftHistoryid without sending the request
136
+ * 想知道某个大佬以前叫什么名字吗?这个接口可以帮你追溯一个 Minecraft 玩家的“黑历史”! ## 功能概述 通过提供玩家的用户名或 UUID,你可以获取到该玩家所有曾用名及其变更时间的列表。这对于识别回归的老玩家或者社区管理非常有用。 ## 使用须知 > [!NOTE] > **参数说明** > - `name` 和 `uuid` 二选一 > - UUID 支持带连字符(如 `ee9b4ed1-aac1-491e-b761-1471be374b80`)或不带连字符格式 > [!IMPORTANT] > **响应结构差异** > - 使用 `uuid` 查询:返回单个用户的历史记录 > - 使用 `name` 查询:返回所有匹配用户的列表(包括当前用户名或曾用名匹配的玩家),需判断响应中是否有 `results` 字段来区分两种模式
137
+ * 查询 MC 曾用名
145
138
  */
146
- async getGameMinecraftHistoryidRequestOpts(requestParameters: GetGameMinecraftHistoryidRequest): Promise<runtime.RequestOpts> {
139
+ async getGameMinecraftHistoryidRaw(requestParameters: GetGameMinecraftHistoryidRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetGameMinecraftHistoryid200Response>> {
147
140
  const queryParameters: any = {};
148
141
 
149
142
  if (requestParameters['name'] != null) {
@@ -159,21 +152,12 @@ export class GameApi extends runtime.BaseAPI {
159
152
 
160
153
  let urlPath = `/game/minecraft/historyid`;
161
154
 
162
- return {
155
+ const response = await this.request({
163
156
  path: urlPath,
164
157
  method: 'GET',
165
158
  headers: headerParameters,
166
159
  query: queryParameters,
167
- };
168
- }
169
-
170
- /**
171
- * 想知道某个大佬以前叫什么名字吗?这个接口可以帮你追溯一个 Minecraft 玩家的“黑历史”! ## 功能概述 通过提供玩家的用户名或 UUID,你可以获取到该玩家所有曾用名及其变更时间的列表。这对于识别回归的老玩家或者社区管理非常有用。 ## 使用须知 > [!NOTE] > **参数说明** > - `name` 和 `uuid` 二选一 > - UUID 支持带连字符(如 `ee9b4ed1-aac1-491e-b761-1471be374b80`)或不带连字符格式 > [!IMPORTANT] > **响应结构差异** > - 使用 `uuid` 查询:返回单个用户的历史记录 > - 使用 `name` 查询:返回所有匹配用户的列表(包括当前用户名或曾用名匹配的玩家),需判断响应中是否有 `results` 字段来区分两种模式
172
- * 查询 MC 曾用名
173
- */
174
- async getGameMinecraftHistoryidRaw(requestParameters: GetGameMinecraftHistoryidRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetGameMinecraftHistoryid200Response>> {
175
- const requestOptions = await this.getGameMinecraftHistoryidRequestOpts(requestParameters);
176
- const response = await this.request(requestOptions, initOverrides);
160
+ }, initOverrides);
177
161
 
178
162
  return new runtime.JSONApiResponse(response, (jsonValue) => GetGameMinecraftHistoryid200ResponseFromJSON(jsonValue));
179
163
  }
@@ -188,9 +172,10 @@ export class GameApi extends runtime.BaseAPI {
188
172
  }
189
173
 
190
174
  /**
191
- * Creates request options for getGameMinecraftServerstatus without sending the request
175
+ * 想在加入服务器前看看有多少人在线?或者检查一下服务器开没开?用这个接口就对了! ## 功能概述 你可以通过提供服务器地址(域名或IP),来获取一个 Minecraft Java 版服务器的实时状态。返回信息非常丰富,包括服务器是否在线、当前玩家数、最大玩家数、服务器版本、MOTD(每日消息)以及服务器图标等。
176
+ * 查询 MC 服务器
192
177
  */
193
- async getGameMinecraftServerstatusRequestOpts(requestParameters: GetGameMinecraftServerstatusRequest): Promise<runtime.RequestOpts> {
178
+ async getGameMinecraftServerstatusRaw(requestParameters: GetGameMinecraftServerstatusRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetGameMinecraftServerstatus200Response>> {
194
179
  if (requestParameters['server'] == null) {
195
180
  throw new runtime.RequiredError(
196
181
  'server',
@@ -209,21 +194,12 @@ export class GameApi extends runtime.BaseAPI {
209
194
 
210
195
  let urlPath = `/game/minecraft/serverstatus`;
211
196
 
212
- return {
197
+ const response = await this.request({
213
198
  path: urlPath,
214
199
  method: 'GET',
215
200
  headers: headerParameters,
216
201
  query: queryParameters,
217
- };
218
- }
219
-
220
- /**
221
- * 想在加入服务器前看看有多少人在线?或者检查一下服务器开没开?用这个接口就对了! ## 功能概述 你可以通过提供服务器地址(域名或IP),来获取一个 Minecraft Java 版服务器的实时状态。返回信息非常丰富,包括服务器是否在线、当前玩家数、最大玩家数、服务器版本、MOTD(每日消息)以及服务器图标等。
222
- * 查询 MC 服务器
223
- */
224
- async getGameMinecraftServerstatusRaw(requestParameters: GetGameMinecraftServerstatusRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetGameMinecraftServerstatus200Response>> {
225
- const requestOptions = await this.getGameMinecraftServerstatusRequestOpts(requestParameters);
226
- const response = await this.request(requestOptions, initOverrides);
202
+ }, initOverrides);
227
203
 
228
204
  return new runtime.JSONApiResponse(response, (jsonValue) => GetGameMinecraftServerstatus200ResponseFromJSON(jsonValue));
229
205
  }
@@ -238,9 +214,10 @@ export class GameApi extends runtime.BaseAPI {
238
214
  }
239
215
 
240
216
  /**
241
- * Creates request options for getGameMinecraftUserinfo without sending the request
217
+ * 只需要一个玩家的用户名,就能快速获取到他的正版皮肤和独一无二的UUID! ## 功能概述 这是一个基础但非常实用的接口。通过玩家当前的游戏内名称(Username),你可以查询到他对应的UUID(唯一标识符)和当前皮肤的URL地址。这是构建许多其他玩家相关服务的第一步。
218
+ * 查询 MC 玩家
242
219
  */
243
- async getGameMinecraftUserinfoRequestOpts(requestParameters: GetGameMinecraftUserinfoRequest): Promise<runtime.RequestOpts> {
220
+ async getGameMinecraftUserinfoRaw(requestParameters: GetGameMinecraftUserinfoRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetGameMinecraftUserinfo200Response>> {
244
221
  if (requestParameters['username'] == null) {
245
222
  throw new runtime.RequiredError(
246
223
  'username',
@@ -259,21 +236,12 @@ export class GameApi extends runtime.BaseAPI {
259
236
 
260
237
  let urlPath = `/game/minecraft/userinfo`;
261
238
 
262
- return {
239
+ const response = await this.request({
263
240
  path: urlPath,
264
241
  method: 'GET',
265
242
  headers: headerParameters,
266
243
  query: queryParameters,
267
- };
268
- }
269
-
270
- /**
271
- * 只需要一个玩家的用户名,就能快速获取到他的正版皮肤和独一无二的UUID! ## 功能概述 这是一个基础但非常实用的接口。通过玩家当前的游戏内名称(Username),你可以查询到他对应的UUID(唯一标识符)和当前皮肤的URL地址。这是构建许多其他玩家相关服务的第一步。
272
- * 查询 MC 玩家
273
- */
274
- async getGameMinecraftUserinfoRaw(requestParameters: GetGameMinecraftUserinfoRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetGameMinecraftUserinfo200Response>> {
275
- const requestOptions = await this.getGameMinecraftUserinfoRequestOpts(requestParameters);
276
- const response = await this.request(requestOptions, initOverrides);
244
+ }, initOverrides);
277
245
 
278
246
  return new runtime.JSONApiResponse(response, (jsonValue) => GetGameMinecraftUserinfo200ResponseFromJSON(jsonValue));
279
247
  }
@@ -288,9 +256,10 @@ export class GameApi extends runtime.BaseAPI {
288
256
  }
289
257
 
290
258
  /**
291
- * Creates request options for getGameSteamSummary without sending the request
259
+ * 想在你的网站或应用中展示用户的 Steam 个人资料?这个接口就是为你准备的。 ## 功能概述 通过一个用户的 Steam 标识(支持多种格式),你可以获取到他公开的个人资料摘要,包括昵称、头像、在线状态、真实姓名(如果公开)和个人资料主页URL等信息。 ## 支持的参数格式 接口现在支持以下几种标识符格式: - **`steamid`**: 64位SteamID(如 `76561197960287930`) - **`id`**: 自定义URL名称(如 `gabelogannewell`) - **`id3`**: Steam ID3格式(如 `STEAM_0:0:22202`) - 完整的个人资料链接 - 好友代码 ## 使用须知 > [!IMPORTANT] > **API Key 安全** > 此接口需要一个 Steam Web API Key。我们强烈建议由后端统一配置和调用,以避免在客户端泄露。当然,你也可以通过 `key` 查询参数临时提供一个Key来覆盖后端配置。 在处理响应时,请注意以下数字代码的含义: - **`personastate` (用户状态)**: 0-离线, 1-在线, 2-忙碌, 3-离开, 4-打盹, 5-想交易, 6-想玩。 - **`communityvisibilitystate` (社区可见性)**: 1-私密, 3-公开 (API通常只能查到这两种状态)。
260
+ * 查询 Steam 用户
292
261
  */
293
- async getGameSteamSummaryRequestOpts(requestParameters: GetGameSteamSummaryRequest): Promise<runtime.RequestOpts> {
262
+ async getGameSteamSummaryRaw(requestParameters: GetGameSteamSummaryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetGameSteamSummary200Response>> {
294
263
  const queryParameters: any = {};
295
264
 
296
265
  if (requestParameters['steamid'] != null) {
@@ -314,21 +283,12 @@ export class GameApi extends runtime.BaseAPI {
314
283
 
315
284
  let urlPath = `/game/steam/summary`;
316
285
 
317
- return {
286
+ const response = await this.request({
318
287
  path: urlPath,
319
288
  method: 'GET',
320
289
  headers: headerParameters,
321
290
  query: queryParameters,
322
- };
323
- }
324
-
325
- /**
326
- * 想在你的网站或应用中展示用户的 Steam 个人资料?这个接口就是为你准备的。 ## 功能概述 通过一个用户的 Steam 标识(支持多种格式),你可以获取到他公开的个人资料摘要,包括昵称、头像、在线状态、真实姓名(如果公开)和个人资料主页URL等信息。 ## 支持的参数格式 接口现在支持以下几种标识符格式: - **`steamid`**: 64位SteamID(如 `76561197960287930`) - **`id`**: 自定义URL名称(如 `gabelogannewell`) - **`id3`**: Steam ID3格式(如 `STEAM_0:0:22202`) - 完整的个人资料链接 - 好友代码 ## 使用须知 > [!IMPORTANT] > **API Key 安全** > 此接口需要一个 Steam Web API Key。我们强烈建议由后端统一配置和调用,以避免在客户端泄露。当然,你也可以通过 `key` 查询参数临时提供一个Key来覆盖后端配置。 在处理响应时,请注意以下数字代码的含义: - **`personastate` (用户状态)**: 0-离线, 1-在线, 2-忙碌, 3-离开, 4-打盹, 5-想交易, 6-想玩。 - **`communityvisibilitystate` (社区可见性)**: 1-私密, 3-公开 (API通常只能查到这两种状态)。
327
- * 查询 Steam 用户
328
- */
329
- async getGameSteamSummaryRaw(requestParameters: GetGameSteamSummaryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetGameSteamSummary200Response>> {
330
- const requestOptions = await this.getGameSteamSummaryRequestOpts(requestParameters);
331
- const response = await this.request(requestOptions, initOverrides);
291
+ }, initOverrides);
332
292
 
333
293
  return new runtime.JSONApiResponse(response, (jsonValue) => GetGameSteamSummary200ResponseFromJSON(jsonValue));
334
294
  }