uapi-browser-sdk 0.1.0

package/internal/src/apis/MiscApi.ts

@@ -0,0 +1,675 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * UAPI
+ * UAPI 官方接口文档
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+import * as runtime from '../runtime';
+import type {
+  GetHistoryProgrammer200Response,
+  GetHistoryProgrammer400Response,
+  GetHistoryProgrammerToday200Response,
+  GetHistoryProgrammerToday500Response,
+  GetMiscHotboard200Response,
+  GetMiscHotboard400Response,
+  GetMiscHotboard500Response,
+  GetMiscHotboard502Response,
+  GetMiscPhoneinfo200Response,
+  GetMiscPhoneinfo400Response,
+  GetMiscPhoneinfo500Response,
+  GetMiscRandomnumber200Response,
+  GetMiscRandomnumber400Response,
+  GetMiscTimestamp200Response,
+  GetMiscTimestamp400Response,
+  GetMiscTrackingCarriers200Response,
+  GetMiscTrackingDetect200Response,
+  GetMiscTrackingDetect404Response,
+  GetMiscTrackingQuery200Response,
+  GetMiscTrackingQuery400Response,
+  GetMiscTrackingQuery404Response,
+  GetMiscWeather200Response,
+  GetMiscWeather400Response,
+  GetMiscWeather410Response,
+  GetMiscWeather500Response,
+  GetMiscWeather502Response,
+  GetMiscWorldtime200Response,
+  GetMiscWorldtime400Response,
+  GetMiscWorldtime404Response,
+} from '../models/index';
+import {
+    GetHistoryProgrammer200ResponseFromJSON,
+    GetHistoryProgrammer200ResponseToJSON,
+    GetHistoryProgrammer400ResponseFromJSON,
+    GetHistoryProgrammer400ResponseToJSON,
+    GetHistoryProgrammerToday200ResponseFromJSON,
+    GetHistoryProgrammerToday200ResponseToJSON,
+    GetHistoryProgrammerToday500ResponseFromJSON,
+    GetHistoryProgrammerToday500ResponseToJSON,
+    GetMiscHotboard200ResponseFromJSON,
+    GetMiscHotboard200ResponseToJSON,
+    GetMiscHotboard400ResponseFromJSON,
+    GetMiscHotboard400ResponseToJSON,
+    GetMiscHotboard500ResponseFromJSON,
+    GetMiscHotboard500ResponseToJSON,
+    GetMiscHotboard502ResponseFromJSON,
+    GetMiscHotboard502ResponseToJSON,
+    GetMiscPhoneinfo200ResponseFromJSON,
+    GetMiscPhoneinfo200ResponseToJSON,
+    GetMiscPhoneinfo400ResponseFromJSON,
+    GetMiscPhoneinfo400ResponseToJSON,
+    GetMiscPhoneinfo500ResponseFromJSON,
+    GetMiscPhoneinfo500ResponseToJSON,
+    GetMiscRandomnumber200ResponseFromJSON,
+    GetMiscRandomnumber200ResponseToJSON,
+    GetMiscRandomnumber400ResponseFromJSON,
+    GetMiscRandomnumber400ResponseToJSON,
+    GetMiscTimestamp200ResponseFromJSON,
+    GetMiscTimestamp200ResponseToJSON,
+    GetMiscTimestamp400ResponseFromJSON,
+    GetMiscTimestamp400ResponseToJSON,
+    GetMiscTrackingCarriers200ResponseFromJSON,
+    GetMiscTrackingCarriers200ResponseToJSON,
+    GetMiscTrackingDetect200ResponseFromJSON,
+    GetMiscTrackingDetect200ResponseToJSON,
+    GetMiscTrackingDetect404ResponseFromJSON,
+    GetMiscTrackingDetect404ResponseToJSON,
+    GetMiscTrackingQuery200ResponseFromJSON,
+    GetMiscTrackingQuery200ResponseToJSON,
+    GetMiscTrackingQuery400ResponseFromJSON,
+    GetMiscTrackingQuery400ResponseToJSON,
+    GetMiscTrackingQuery404ResponseFromJSON,
+    GetMiscTrackingQuery404ResponseToJSON,
+    GetMiscWeather200ResponseFromJSON,
+    GetMiscWeather200ResponseToJSON,
+    GetMiscWeather400ResponseFromJSON,
+    GetMiscWeather400ResponseToJSON,
+    GetMiscWeather410ResponseFromJSON,
+    GetMiscWeather410ResponseToJSON,
+    GetMiscWeather500ResponseFromJSON,
+    GetMiscWeather500ResponseToJSON,
+    GetMiscWeather502ResponseFromJSON,
+    GetMiscWeather502ResponseToJSON,
+    GetMiscWorldtime200ResponseFromJSON,
+    GetMiscWorldtime200ResponseToJSON,
+    GetMiscWorldtime400ResponseFromJSON,
+    GetMiscWorldtime400ResponseToJSON,
+    GetMiscWorldtime404ResponseFromJSON,
+    GetMiscWorldtime404ResponseToJSON,
+} from '../models/index';
+
+export interface GetHistoryProgrammerRequest {
+    month: number;
+    day: number;
+}
+
+export interface GetMiscHotboardRequest {
+    type: GetMiscHotboardTypeEnum;
+}
+
+export interface GetMiscPhoneinfoRequest {
+    phone: string;
+}
+
+export interface GetMiscRandomnumberRequest {
+    min?: number;
+    max?: number;
+    count?: number;
+    allowRepeat?: boolean;
+    allowDecimal?: boolean;
+    decimalPlaces?: number;
+}
+
+export interface GetMiscTimestampRequest {
+    ts: string;
+}
+
+export interface GetMiscTrackingDetectRequest {
+    trackingNumber: string;
+}
+
+export interface GetMiscTrackingQueryRequest {
+    trackingNumber: string;
+    carrierCode?: string;
+}
+
+export interface GetMiscWeatherRequest {
+    city?: string;
+    adcode?: string;
+}
+
+export interface GetMiscWorldtimeRequest {
+    city: string;
+}
+
+/**
+ * 
+ */
+export class MiscApi extends runtime.BaseAPI {
+
+    /**
+     * 想查看程序员历史上某个特定日期发生的大事件？指定月份和日期，我们就能告诉你！  ## 功能概述 通过指定月份和日期，获取该日发生的程序员相关历史事件。同样使用AI智能筛选，确保事件的相关性和重要性。
+     * 获取指定日期的程序员历史事件
+     */
+    async getHistoryProgrammerRaw(requestParameters: GetHistoryProgrammerRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetHistoryProgrammer200Response>> {
+        if (requestParameters['month'] == null) {
+            throw new runtime.RequiredError(
+                'month',
+                'Required parameter "month" was null or undefined when calling getHistoryProgrammer().'
+            );
+        }
+
+        if (requestParameters['day'] == null) {
+            throw new runtime.RequiredError(
+                'day',
+                'Required parameter "day" was null or undefined when calling getHistoryProgrammer().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['month'] != null) {
+            queryParameters['month'] = requestParameters['month'];
+        }
+
+        if (requestParameters['day'] != null) {
+            queryParameters['day'] = requestParameters['day'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/history/programmer`;
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetHistoryProgrammer200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 想查看程序员历史上某个特定日期发生的大事件？指定月份和日期，我们就能告诉你！  ## 功能概述 通过指定月份和日期，获取该日发生的程序员相关历史事件。同样使用AI智能筛选，确保事件的相关性和重要性。
+     * 获取指定日期的程序员历史事件
+     */
+    async getHistoryProgrammer(requestParameters: GetHistoryProgrammerRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetHistoryProgrammer200Response> {
+        const response = await this.getHistoryProgrammerRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * 想知道程序员历史上的今天发生了什么大事吗？这个接口告诉你答案！  ## 功能概述 我们使用AI智能筛选从海量历史事件中挑选出与程序员、计算机科学相关的重要事件。每个事件都经过重要性评分和相关性评分，确保内容质量。
+     * 获取今天的程序员历史事件
+     */
+    async getHistoryProgrammerTodayRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetHistoryProgrammerToday200Response>> {
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/history/programmer/today`;
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetHistoryProgrammerToday200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 想知道程序员历史上的今天发生了什么大事吗？这个接口告诉你答案！  ## 功能概述 我们使用AI智能筛选从海量历史事件中挑选出与程序员、计算机科学相关的重要事件。每个事件都经过重要性评分和相关性评分，确保内容质量。
+     * 获取今天的程序员历史事件
+     */
+    async getHistoryProgrammerToday(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetHistoryProgrammerToday200Response> {
+        const response = await this.getHistoryProgrammerTodayRaw(initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * 想快速跟上网络热点？这个接口让你一网打尽各大主流平台的实时热榜/热搜！  ## 功能概述 你只需要指定一个平台类型，就能获取到该平台当前的热榜数据列表。每个热榜条目都包含标题、热度值和原始链接。非常适合用于制作信息聚合类应用或看板。  ## 可选值 `type` 参数接受多种不同的值，每种值对应一个不同的热榜来源。以下是目前支持的所有值：  | 分类       | 支持的 type 值 | |------------|-----------------------------------------------------------------------------------------------------------------------------------| | 视频/社区  | bilibili（哔哩哔哩弹幕网）, acfun（A站弹幕视频网站）, weibo（新浪微博热搜）, zhihu（知乎热榜）, zhihu-daily（知乎日报热榜）, douyin（抖音热榜）, kuaishou（快手热榜）, douban-movie（豆瓣电影榜单）, douban-group（豆瓣小组话题）, tieba（百度贴吧热帖）, hupu（虎扑热帖）, miyoushe（米游社话题榜）, ngabbs（NGA游戏论坛热帖）, v2ex（V2EX技术社区热帖）, 52pojie（吾爱破解热帖）, hostloc（全球主机交流论坛）, coolapk（酷安热榜） | | 新闻/资讯  | baidu（百度热搜）, thepaper（澎湃新闻热榜）, toutiao（今日头条热榜）, qq-news（腾讯新闻热榜）, sina（新浪热搜）, sina-news（新浪新闻热榜）, netease-news（网易新闻热榜）, huxiu（虎嗅网热榜）, ifanr（爱范儿热榜） | | 技术/IT    | sspai（少数派热榜）, ithome（IT之家热榜）, ithome-xijiayi（IT之家·喜加一栏目）, juejin（掘金社区热榜）, jianshu（简书热榜）, guokr（果壳热榜）, 36kr（36氪热榜）, 51cto（51CTO热榜）, csdn（CSDN博客热榜）, nodeseek（NodeSeek 技术社区）, hellogithub（HelloGitHub 项目推荐） | | 游戏       | lol（英雄联盟热帖）, genshin（原神热榜）, honkai（崩坏3热榜）, starrail（星穹铁道热榜） | | 其他       | weread（微信读书热门书籍）, weatheralarm（天气预警信息）, earthquake（地震速报）, history（历史上的今天） | 
+     * 获取多平台实时热榜
+     */
+    async getMiscHotboardRaw(requestParameters: GetMiscHotboardRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetMiscHotboard200Response>> {
+        if (requestParameters['type'] == null) {
+            throw new runtime.RequiredError(
+                'type',
+                'Required parameter "type" was null or undefined when calling getMiscHotboard().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['type'] != null) {
+            queryParameters['type'] = requestParameters['type'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/misc/hotboard`;
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetMiscHotboard200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 想快速跟上网络热点？这个接口让你一网打尽各大主流平台的实时热榜/热搜！  ## 功能概述 你只需要指定一个平台类型，就能获取到该平台当前的热榜数据列表。每个热榜条目都包含标题、热度值和原始链接。非常适合用于制作信息聚合类应用或看板。  ## 可选值 `type` 参数接受多种不同的值，每种值对应一个不同的热榜来源。以下是目前支持的所有值：  | 分类       | 支持的 type 值 | |------------|-----------------------------------------------------------------------------------------------------------------------------------| | 视频/社区  | bilibili（哔哩哔哩弹幕网）, acfun（A站弹幕视频网站）, weibo（新浪微博热搜）, zhihu（知乎热榜）, zhihu-daily（知乎日报热榜）, douyin（抖音热榜）, kuaishou（快手热榜）, douban-movie（豆瓣电影榜单）, douban-group（豆瓣小组话题）, tieba（百度贴吧热帖）, hupu（虎扑热帖）, miyoushe（米游社话题榜）, ngabbs（NGA游戏论坛热帖）, v2ex（V2EX技术社区热帖）, 52pojie（吾爱破解热帖）, hostloc（全球主机交流论坛）, coolapk（酷安热榜） | | 新闻/资讯  | baidu（百度热搜）, thepaper（澎湃新闻热榜）, toutiao（今日头条热榜）, qq-news（腾讯新闻热榜）, sina（新浪热搜）, sina-news（新浪新闻热榜）, netease-news（网易新闻热榜）, huxiu（虎嗅网热榜）, ifanr（爱范儿热榜） | | 技术/IT    | sspai（少数派热榜）, ithome（IT之家热榜）, ithome-xijiayi（IT之家·喜加一栏目）, juejin（掘金社区热榜）, jianshu（简书热榜）, guokr（果壳热榜）, 36kr（36氪热榜）, 51cto（51CTO热榜）, csdn（CSDN博客热榜）, nodeseek（NodeSeek 技术社区）, hellogithub（HelloGitHub 项目推荐） | | 游戏       | lol（英雄联盟热帖）, genshin（原神热榜）, honkai（崩坏3热榜）, starrail（星穹铁道热榜） | | 其他       | weread（微信读书热门书籍）, weatheralarm（天气预警信息）, earthquake（地震速报）, history（历史上的今天） | 
+     * 获取多平台实时热榜
+     */
+    async getMiscHotboard(requestParameters: GetMiscHotboardRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetMiscHotboard200Response> {
+        const response = await this.getMiscHotboardRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * 想知道一个手机号码来自哪里？是移动、联通还是电信？这个接口可以告诉你答案。  ## 功能概述 提供一个国内的手机号码，我们会查询并返回它的归属地（省份和城市）以及所属的运营商信息。
+     * 查询手机号码归属地信息
+     */
+    async getMiscPhoneinfoRaw(requestParameters: GetMiscPhoneinfoRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetMiscPhoneinfo200Response>> {
+        if (requestParameters['phone'] == null) {
+            throw new runtime.RequiredError(
+                'phone',
+                'Required parameter "phone" was null or undefined when calling getMiscPhoneinfo().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['phone'] != null) {
+            queryParameters['phone'] = requestParameters['phone'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/misc/phoneinfo`;
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetMiscPhoneinfo200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 想知道一个手机号码来自哪里？是移动、联通还是电信？这个接口可以告诉你答案。  ## 功能概述 提供一个国内的手机号码，我们会查询并返回它的归属地（省份和城市）以及所属的运营商信息。
+     * 查询手机号码归属地信息
+     */
+    async getMiscPhoneinfo(requestParameters: GetMiscPhoneinfoRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetMiscPhoneinfo200Response> {
+        const response = await this.getMiscPhoneinfoRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * 需要一个简单的随机数，还是需要一串不重复的、带小数的随机数？这个接口都能满足你！  ## 功能概述 这是一个强大的随机数生成器。你可以指定生成的范围（最大/最小值）、数量、是否允许重复、以及是否生成小数（并指定小数位数）。  ## 流程图 ```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 错误。
+     * 生成高度可定制的随机数
+     */
+    async getMiscRandomnumberRaw(requestParameters: GetMiscRandomnumberRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetMiscRandomnumber200Response>> {
+        const queryParameters: any = {};
+
+        if (requestParameters['min'] != null) {
+            queryParameters['min'] = requestParameters['min'];
+        }
+
+        if (requestParameters['max'] != null) {
+            queryParameters['max'] = requestParameters['max'];
+        }
+
+        if (requestParameters['count'] != null) {
+            queryParameters['count'] = requestParameters['count'];
+        }
+
+        if (requestParameters['allowRepeat'] != null) {
+            queryParameters['allow_repeat'] = requestParameters['allowRepeat'];
+        }
+
+        if (requestParameters['allowDecimal'] != null) {
+            queryParameters['allow_decimal'] = requestParameters['allowDecimal'];
+        }
+
+        if (requestParameters['decimalPlaces'] != null) {
+            queryParameters['decimal_places'] = requestParameters['decimalPlaces'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/misc/randomnumber`;
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetMiscRandomnumber200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 需要一个简单的随机数，还是需要一串不重复的、带小数的随机数？这个接口都能满足你！  ## 功能概述 这是一个强大的随机数生成器。你可以指定生成的范围（最大/最小值）、数量、是否允许重复、以及是否生成小数（并指定小数位数）。  ## 流程图 ```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 错误。
+     * 生成高度可定制的随机数
+     */
+    async getMiscRandomnumber(requestParameters: GetMiscRandomnumberRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetMiscRandomnumber200Response> {
+        const response = await this.getMiscRandomnumberRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * 这是一个用于将Unix时间戳转换为人类可读日期时间的旧版接口。  ## 功能概述 输入一个秒级或毫秒级的时间戳，返回其对应的本地时间和UTC时间。  > [!WARNING] > **接口已过时**：这个接口已被新的 `/convert/unixtime` 取代。新接口功能更强大，支持双向转换。我们建议你迁移到新接口。  [👉 前往新版接口文档](/docs/api-reference/get-convert-unixtime)
+     * 转换时间戳 (旧版，推荐使用/convert/unixtime)
+     */
+    async getMiscTimestampRaw(requestParameters: GetMiscTimestampRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetMiscTimestamp200Response>> {
+        if (requestParameters['ts'] == null) {
+            throw new runtime.RequiredError(
+                'ts',
+                'Required parameter "ts" was null or undefined when calling getMiscTimestamp().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['ts'] != null) {
+            queryParameters['ts'] = requestParameters['ts'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/misc/timestamp`;
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetMiscTimestamp200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 这是一个用于将Unix时间戳转换为人类可读日期时间的旧版接口。  ## 功能概述 输入一个秒级或毫秒级的时间戳，返回其对应的本地时间和UTC时间。  > [!WARNING] > **接口已过时**：这个接口已被新的 `/convert/unixtime` 取代。新接口功能更强大，支持双向转换。我们建议你迁移到新接口。  [👉 前往新版接口文档](/docs/api-reference/get-convert-unixtime)
+     * 转换时间戳 (旧版，推荐使用/convert/unixtime)
+     */
+    async getMiscTimestamp(requestParameters: GetMiscTimestampRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetMiscTimestamp200Response> {
+        const response = await this.getMiscTimestampRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * 不确定系统支持哪些快递公司？这个接口返回完整的支持列表。  > [!VIP] > 本API目前处于**限时免费**阶段，我们鼓励开发者集成和测试。未来，它将转为付费API，为用户提供更稳定和强大的服务。  ## 功能概述 获取系统当前支持的所有快递公司列表，包括每家公司的标准编码（code）和中文名称（name）。  ## 使用建议 - **推荐缓存**：这个列表基本不会频繁变动，建议在应用启动时调用一次并缓存到本地 - **应用场景**：适合用于构建快递公司选择器、下拉菜单等UI组件 - **缓存时长**：建议缓存24小时或更久
+     * 获取支持的快递公司列表
+     */
+    async getMiscTrackingCarriersRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetMiscTrackingCarriers200Response>> {
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/misc/tracking/carriers`;
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetMiscTrackingCarriers200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 不确定系统支持哪些快递公司？这个接口返回完整的支持列表。  > [!VIP] > 本API目前处于**限时免费**阶段，我们鼓励开发者集成和测试。未来，它将转为付费API，为用户提供更稳定和强大的服务。  ## 功能概述 获取系统当前支持的所有快递公司列表，包括每家公司的标准编码（code）和中文名称（name）。  ## 使用建议 - **推荐缓存**：这个列表基本不会频繁变动，建议在应用启动时调用一次并缓存到本地 - **应用场景**：适合用于构建快递公司选择器、下拉菜单等UI组件 - **缓存时长**：建议缓存24小时或更久
+     * 获取支持的快递公司列表
+     */
+    async getMiscTrackingCarriers(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetMiscTrackingCarriers200Response> {
+        const response = await this.getMiscTrackingCarriersRaw(initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * 不确定手里的快递单号属于哪家快递公司？这个接口专门做识别，不查物流。  > [!VIP] > 本API目前处于**限时免费**阶段，我们鼓励开发者集成和测试。未来，它将转为付费API，为用户提供更稳定和强大的服务。  ## 功能概述 输入快递单号，系统会根据单号规则快速识别出最可能的快递公司。如果存在多个可能的匹配结果，还会在 `alternatives` 字段中返回备选项，供你参考选择。  ## 使用须知 - **识别速度快**：只做规则匹配，不查询物流信息，响应速度通常在100ms内 - **准确率高**：基于各快递公司的单号规则进行智能识别，准确率超过95% - **备选方案**：当单号规则可能匹配多家快递公司时，会提供所有可能的选项
+     * 识别快递公司
+     */
+    async getMiscTrackingDetectRaw(requestParameters: GetMiscTrackingDetectRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetMiscTrackingDetect200Response>> {
+        if (requestParameters['trackingNumber'] == null) {
+            throw new runtime.RequiredError(
+                'trackingNumber',
+                'Required parameter "trackingNumber" was null or undefined when calling getMiscTrackingDetect().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['trackingNumber'] != null) {
+            queryParameters['tracking_number'] = requestParameters['trackingNumber'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/misc/tracking/detect`;
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetMiscTrackingDetect200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 不确定手里的快递单号属于哪家快递公司？这个接口专门做识别，不查物流。  > [!VIP] > 本API目前处于**限时免费**阶段，我们鼓励开发者集成和测试。未来，它将转为付费API，为用户提供更稳定和强大的服务。  ## 功能概述 输入快递单号，系统会根据单号规则快速识别出最可能的快递公司。如果存在多个可能的匹配结果，还会在 `alternatives` 字段中返回备选项，供你参考选择。  ## 使用须知 - **识别速度快**：只做规则匹配，不查询物流信息，响应速度通常在100ms内 - **准确率高**：基于各快递公司的单号规则进行智能识别，准确率超过95% - **备选方案**：当单号规则可能匹配多家快递公司时，会提供所有可能的选项
+     * 识别快递公司
+     */
+    async getMiscTrackingDetect(requestParameters: GetMiscTrackingDetectRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetMiscTrackingDetect200Response> {
+        const response = await this.getMiscTrackingDetectRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * 买了东西想知道快递到哪儿了？这个接口帮你实时追踪物流状态。  > [!VIP] > 本API目前处于**限时免费**阶段，我们鼓励开发者集成和测试。未来，它将转为付费API，为用户提供更稳定和强大的服务。  ## 功能概述 提供一个快递单号，系统会自动识别快递公司并返回完整的物流轨迹信息。支持中通、圆通、韵达、申通、极兔、顺丰、京东、EMS、德邦等60+国内外主流快递公司。  ## 使用须知 - **自动识别**：不知道是哪家快递？系统会根据单号规则自动识别快递公司（推荐使用） - **手动指定**：如果已知快递公司，可以传递 `carrier_code` 参数，查询速度会更快 - **查询时效**：物流信息实时查询，响应时间通常在1-2秒内
+     * 查询快递物流信息
+     */
+    async getMiscTrackingQueryRaw(requestParameters: GetMiscTrackingQueryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetMiscTrackingQuery200Response>> {
+        if (requestParameters['trackingNumber'] == null) {
+            throw new runtime.RequiredError(
+                'trackingNumber',
+                'Required parameter "trackingNumber" was null or undefined when calling getMiscTrackingQuery().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['trackingNumber'] != null) {
+            queryParameters['tracking_number'] = requestParameters['trackingNumber'];
+        }
+
+        if (requestParameters['carrierCode'] != null) {
+            queryParameters['carrier_code'] = requestParameters['carrierCode'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/misc/tracking/query`;
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetMiscTrackingQuery200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 买了东西想知道快递到哪儿了？这个接口帮你实时追踪物流状态。  > [!VIP] > 本API目前处于**限时免费**阶段，我们鼓励开发者集成和测试。未来，它将转为付费API，为用户提供更稳定和强大的服务。  ## 功能概述 提供一个快递单号，系统会自动识别快递公司并返回完整的物流轨迹信息。支持中通、圆通、韵达、申通、极兔、顺丰、京东、EMS、德邦等60+国内外主流快递公司。  ## 使用须知 - **自动识别**：不知道是哪家快递？系统会根据单号规则自动识别快递公司（推荐使用） - **手动指定**：如果已知快递公司，可以传递 `carrier_code` 参数，查询速度会更快 - **查询时效**：物流信息实时查询，响应时间通常在1-2秒内
+     * 查询快递物流信息
+     */
+    async getMiscTrackingQuery(requestParameters: GetMiscTrackingQueryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetMiscTrackingQuery200Response> {
+        const response = await this.getMiscTrackingQueryRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * 出门前，查一下天气总是个好习惯。这个接口为你提供精准、实时的天气数据。  ## 功能概述 你可以通过城市名称或高德地图的Adcode来查询指定地区的实时天气状况，包括天气现象、温度、湿度、风向和风力等。  ## 使用须知 - **参数优先级**：当你同时提供了 `city` (城市名) 和 `adcode` (城市编码) 两个参数时，系统会 **优先使用 `adcode`** 进行查询，因为它更精确。 - **查询范围**：为了保证查询的准确性，我们的服务仅支持标准的“省”、“市”、“区/县”级别的行政区划名称查询，不保证能查询到乡镇或具体地点。  ## 错误处理指南 - **410 Gone**: 这个特殊的错误码意味着你查询的地区无效或不受我们支持。比如你输入了“火星”，或者某个我们无法识别的村庄名称。这个状态码告诉你，这个“资源”是永久性地不可用了。
+     * 查询实时天气信息
+     */
+    async getMiscWeatherRaw(requestParameters: GetMiscWeatherRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetMiscWeather200Response>> {
+        const queryParameters: any = {};
+
+        if (requestParameters['city'] != null) {
+            queryParameters['city'] = requestParameters['city'];
+        }
+
+        if (requestParameters['adcode'] != null) {
+            queryParameters['adcode'] = requestParameters['adcode'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/misc/weather`;
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetMiscWeather200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 出门前，查一下天气总是个好习惯。这个接口为你提供精准、实时的天气数据。  ## 功能概述 你可以通过城市名称或高德地图的Adcode来查询指定地区的实时天气状况，包括天气现象、温度、湿度、风向和风力等。  ## 使用须知 - **参数优先级**：当你同时提供了 `city` (城市名) 和 `adcode` (城市编码) 两个参数时，系统会 **优先使用 `adcode`** 进行查询，因为它更精确。 - **查询范围**：为了保证查询的准确性，我们的服务仅支持标准的“省”、“市”、“区/县”级别的行政区划名称查询，不保证能查询到乡镇或具体地点。  ## 错误处理指南 - **410 Gone**: 这个特殊的错误码意味着你查询的地区无效或不受我们支持。比如你输入了“火星”，或者某个我们无法识别的村庄名称。这个状态码告诉你，这个“资源”是永久性地不可用了。
+     * 查询实时天气信息
+     */
+    async getMiscWeather(requestParameters: GetMiscWeatherRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetMiscWeather200Response> {
+        const response = await this.getMiscWeatherRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * 需要和国外的朋友开会，想知道他那边现在几点？用这个接口一查便知。  ## 功能概述 根据标准的时区名称（例如 \'Asia/Shanghai\' 或 \'Europe/London\'），获取该时区的当前准确时间、UTC偏移量、星期等信息。
+     * 查询全球任意时区的时间
+     */
+    async getMiscWorldtimeRaw(requestParameters: GetMiscWorldtimeRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetMiscWorldtime200Response>> {
+        if (requestParameters['city'] == null) {
+            throw new runtime.RequiredError(
+                'city',
+                'Required parameter "city" was null or undefined when calling getMiscWorldtime().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['city'] != null) {
+            queryParameters['city'] = requestParameters['city'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/misc/worldtime`;
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetMiscWorldtime200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 需要和国外的朋友开会，想知道他那边现在几点？用这个接口一查便知。  ## 功能概述 根据标准的时区名称（例如 \'Asia/Shanghai\' 或 \'Europe/London\'），获取该时区的当前准确时间、UTC偏移量、星期等信息。
+     * 查询全球任意时区的时间
+     */
+    async getMiscWorldtime(requestParameters: GetMiscWorldtimeRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetMiscWorldtime200Response> {
+        const response = await this.getMiscWorldtimeRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+}
+
+/**
+ * @export
+ */
+export const GetMiscHotboardTypeEnum = {
+    Bilibili: 'bilibili',
+    Acfun: 'acfun',
+    Weibo: 'weibo',
+    Zhihu: 'zhihu',
+    ZhihuDaily: 'zhihu-daily',
+    Douyin: 'douyin',
+    Kuaishou: 'kuaishou',
+    DoubanMovie: 'douban-movie',
+    DoubanGroup: 'douban-group',
+    Tieba: 'tieba',
+    Hupu: 'hupu',
+    Miyoushe: 'miyoushe',
+    Ngabbs: 'ngabbs',
+    V2ex: 'v2ex',
+    _52pojie: '52pojie',
+    Hostloc: 'hostloc',
+    Coolapk: 'coolapk',
+    Baidu: 'baidu',
+    Thepaper: 'thepaper',
+    Toutiao: 'toutiao',
+    QqNews: 'qq-news',
+    Sina: 'sina',
+    SinaNews: 'sina-news',
+    NeteaseNews: 'netease-news',
+    Huxiu: 'huxiu',
+    Ifanr: 'ifanr',
+    Sspai: 'sspai',
+    Ithome: 'ithome',
+    IthomeXijiayi: 'ithome-xijiayi',
+    Juejin: 'juejin',
+    Jianshu: 'jianshu',
+    Guokr: 'guokr',
+    _36kr: '36kr',
+    _51cto: '51cto',
+    Csdn: 'csdn',
+    Nodeseek: 'nodeseek',
+    Hellogithub: 'hellogithub',
+    Lol: 'lol',
+    Genshin: 'genshin',
+    Honkai: 'honkai',
+    Starrail: 'starrail',
+    Weread: 'weread',
+    Weatheralarm: 'weatheralarm',
+    Earthquake: 'earthquake',
+    History: 'history'
+} as const;
+export type GetMiscHotboardTypeEnum = typeof GetMiscHotboardTypeEnum[keyof typeof GetMiscHotboardTypeEnum];