uapi-browser-sdk 0.1.0

package/internal/src/apis/SocialApi.ts

@@ -0,0 +1,489 @@
+/* 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 {
+  GetGithubRepo200Response,
+  GetGithubRepo400Response,
+  GetGithubRepo502Response,
+  GetSocialBilibiliArchives200Response,
+  GetSocialBilibiliArchives400Response,
+  GetSocialBilibiliArchives404Response,
+  GetSocialBilibiliArchives500Response,
+  GetSocialBilibiliLiveroom200Response,
+  GetSocialBilibiliReplies200Response,
+  GetSocialBilibiliUserinfo200Response,
+  GetSocialBilibiliUserinfo400Response,
+  GetSocialBilibiliUserinfo404Response,
+  GetSocialBilibiliUserinfo502Response,
+  GetSocialBilibiliVideoinfo200Response,
+  GetSocialQqGroupinfo200Response,
+  GetSocialQqGroupinfo400Response,
+  GetSocialQqGroupinfo404Response,
+  GetSocialQqGroupinfo500Response,
+  GetSocialQqUserinfo200Response,
+  GetSocialQqUserinfo400Response,
+  GetSocialQqUserinfo404Response,
+} from '../models/index';
+import {
+    GetGithubRepo200ResponseFromJSON,
+    GetGithubRepo200ResponseToJSON,
+    GetGithubRepo400ResponseFromJSON,
+    GetGithubRepo400ResponseToJSON,
+    GetGithubRepo502ResponseFromJSON,
+    GetGithubRepo502ResponseToJSON,
+    GetSocialBilibiliArchives200ResponseFromJSON,
+    GetSocialBilibiliArchives200ResponseToJSON,
+    GetSocialBilibiliArchives400ResponseFromJSON,
+    GetSocialBilibiliArchives400ResponseToJSON,
+    GetSocialBilibiliArchives404ResponseFromJSON,
+    GetSocialBilibiliArchives404ResponseToJSON,
+    GetSocialBilibiliArchives500ResponseFromJSON,
+    GetSocialBilibiliArchives500ResponseToJSON,
+    GetSocialBilibiliLiveroom200ResponseFromJSON,
+    GetSocialBilibiliLiveroom200ResponseToJSON,
+    GetSocialBilibiliReplies200ResponseFromJSON,
+    GetSocialBilibiliReplies200ResponseToJSON,
+    GetSocialBilibiliUserinfo200ResponseFromJSON,
+    GetSocialBilibiliUserinfo200ResponseToJSON,
+    GetSocialBilibiliUserinfo400ResponseFromJSON,
+    GetSocialBilibiliUserinfo400ResponseToJSON,
+    GetSocialBilibiliUserinfo404ResponseFromJSON,
+    GetSocialBilibiliUserinfo404ResponseToJSON,
+    GetSocialBilibiliUserinfo502ResponseFromJSON,
+    GetSocialBilibiliUserinfo502ResponseToJSON,
+    GetSocialBilibiliVideoinfo200ResponseFromJSON,
+    GetSocialBilibiliVideoinfo200ResponseToJSON,
+    GetSocialQqGroupinfo200ResponseFromJSON,
+    GetSocialQqGroupinfo200ResponseToJSON,
+    GetSocialQqGroupinfo400ResponseFromJSON,
+    GetSocialQqGroupinfo400ResponseToJSON,
+    GetSocialQqGroupinfo404ResponseFromJSON,
+    GetSocialQqGroupinfo404ResponseToJSON,
+    GetSocialQqGroupinfo500ResponseFromJSON,
+    GetSocialQqGroupinfo500ResponseToJSON,
+    GetSocialQqUserinfo200ResponseFromJSON,
+    GetSocialQqUserinfo200ResponseToJSON,
+    GetSocialQqUserinfo400ResponseFromJSON,
+    GetSocialQqUserinfo400ResponseToJSON,
+    GetSocialQqUserinfo404ResponseFromJSON,
+    GetSocialQqUserinfo404ResponseToJSON,
+} from '../models/index';
+
+export interface GetGithubRepoRequest {
+    repo: string;
+}
+
+export interface GetSocialBilibiliArchivesRequest {
+    mid: string;
+    keywords?: string;
+    orderby?: string;
+    ps?: string;
+    pn?: string;
+}
+
+export interface GetSocialBilibiliLiveroomRequest {
+    mid?: string;
+    roomId?: string;
+}
+
+export interface GetSocialBilibiliRepliesRequest {
+    oid: string;
+    sort?: string;
+    ps?: string;
+    pn?: string;
+}
+
+export interface GetSocialBilibiliUserinfoRequest {
+    uid: string;
+}
+
+export interface GetSocialBilibiliVideoinfoRequest {
+    aid?: string;
+    bvid?: string;
+}
+
+export interface GetSocialQqGroupinfoRequest {
+    groupId: string;
+}
+
+export interface GetSocialQqUserinfoRequest {
+    qq: string;
+}
+
+/**
+ * 
+ */
+export class SocialApi extends runtime.BaseAPI {
+
+    /**
+     * 需要快速获取一个GitHub仓库的核心信息？这个接口为你聚合了最有价值的数据，避免了多次调用GitHub官方API的麻烦，并且内置了缓存优化，速度更快、更稳定。  ### 聚合高价值数据 一次请求，即可获得以下信息： - **核心指标**: `star`, `fork`, `open_issues` 等关键统计数据。 - **项目详情**: 描述、主页、分支、语言、话题标签、开源协议。 - **参与者信息**: 获取协作者(`collaborators`)和推断的维护者(`maintainers`)列表，包括他们的公开邮箱（如果可用）。  > [!NOTE] > `collaborators` 字段在私有仓库或权限受限时可能为空。`maintainers` 是根据最新提交记录推断的，仅供参考。  ### 性能与稳定性 我们内置了多级缓存，有效避免触发GitHub的API速率限制。对于需要更高请求额度的用户，可以联系我们定制接口。
+     * 获取GitHub仓库信息
+     */
+    async getGithubRepoRaw(requestParameters: GetGithubRepoRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetGithubRepo200Response>> {
+        if (requestParameters['repo'] == null) {
+            throw new runtime.RequiredError(
+                'repo',
+                'Required parameter "repo" was null or undefined when calling getGithubRepo().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['repo'] != null) {
+            queryParameters['repo'] = requestParameters['repo'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/github/repo`;
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetGithubRepo200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 需要快速获取一个GitHub仓库的核心信息？这个接口为你聚合了最有价值的数据，避免了多次调用GitHub官方API的麻烦，并且内置了缓存优化，速度更快、更稳定。  ### 聚合高价值数据 一次请求，即可获得以下信息： - **核心指标**: `star`, `fork`, `open_issues` 等关键统计数据。 - **项目详情**: 描述、主页、分支、语言、话题标签、开源协议。 - **参与者信息**: 获取协作者(`collaborators`)和推断的维护者(`maintainers`)列表，包括他们的公开邮箱（如果可用）。  > [!NOTE] > `collaborators` 字段在私有仓库或权限受限时可能为空。`maintainers` 是根据最新提交记录推断的，仅供参考。  ### 性能与稳定性 我们内置了多级缓存，有效避免触发GitHub的API速率限制。对于需要更高请求额度的用户，可以联系我们定制接口。
+     * 获取GitHub仓库信息
+     */
+    async getGithubRepo(requestParameters: GetGithubRepoRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetGithubRepo200Response> {
+        const response = await this.getGithubRepoRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * 想要获取UP主的所有投稿视频？或者想在你的应用里展示创作者的作品集？这个接口能帮你轻松实现。  ## 功能概述 通过用户的 `mid`（用户ID），你可以获取该UP主的投稿视频列表。接口支持关键词搜索、分页加载和多种排序方式，让你能够灵活地展示和分析创作者的内容。  ## 参数说明 - **`mid` (用户ID)**: B站用户的mid，必填参数。 - **`keywords` (搜索关键词)**: 可选，用于在该UP主的投稿中搜索特定关键词。 - **`orderby` (排序方式)**:    - `pubdate`: 按最新发布排序（默认）   - `views`: 按最多播放排序 - **`ps` (每页条数)**: 默认20条。 - **`pn` (页码)**: 默认1，用于分页。  ## 响应体字段说明 - **`total` (总稿件数)**: UP主的投稿总数。 - **`page` (当前页码)**: 当前返回的页码。 - **`size` (每页数量)**: 每页返回的视频数量。 - **`videos` (视频列表)**: 包含当前页的所有视频信息：   - `aid`: 视频的AV号   - `bvid`: 视频的BV号   - `title`: 视频标题   - `cover`: 封面URL   - `duration`: 时长（秒）   - `play_count`: 播放量   - `publish_time`: 发布时间戳   - `create_time`: 创建时间戳   - `state`: 视频状态   - `is_ugc_pay`: 是否付费视频（0=免费，1=付费）   - `is_interactive`: 是否为互动视频
+     * 获取Bilibili用户投稿列表
+     */
+    async getSocialBilibiliArchivesRaw(requestParameters: GetSocialBilibiliArchivesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetSocialBilibiliArchives200Response>> {
+        if (requestParameters['mid'] == null) {
+            throw new runtime.RequiredError(
+                'mid',
+                'Required parameter "mid" was null or undefined when calling getSocialBilibiliArchives().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['mid'] != null) {
+            queryParameters['mid'] = requestParameters['mid'];
+        }
+
+        if (requestParameters['keywords'] != null) {
+            queryParameters['keywords'] = requestParameters['keywords'];
+        }
+
+        if (requestParameters['orderby'] != null) {
+            queryParameters['orderby'] = requestParameters['orderby'];
+        }
+
+        if (requestParameters['ps'] != null) {
+            queryParameters['ps'] = requestParameters['ps'];
+        }
+
+        if (requestParameters['pn'] != null) {
+            queryParameters['pn'] = requestParameters['pn'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/social/bilibili/archives`;
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetSocialBilibiliArchives200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 想要获取UP主的所有投稿视频？或者想在你的应用里展示创作者的作品集？这个接口能帮你轻松实现。  ## 功能概述 通过用户的 `mid`（用户ID），你可以获取该UP主的投稿视频列表。接口支持关键词搜索、分页加载和多种排序方式，让你能够灵活地展示和分析创作者的内容。  ## 参数说明 - **`mid` (用户ID)**: B站用户的mid，必填参数。 - **`keywords` (搜索关键词)**: 可选，用于在该UP主的投稿中搜索特定关键词。 - **`orderby` (排序方式)**:    - `pubdate`: 按最新发布排序（默认）   - `views`: 按最多播放排序 - **`ps` (每页条数)**: 默认20条。 - **`pn` (页码)**: 默认1，用于分页。  ## 响应体字段说明 - **`total` (总稿件数)**: UP主的投稿总数。 - **`page` (当前页码)**: 当前返回的页码。 - **`size` (每页数量)**: 每页返回的视频数量。 - **`videos` (视频列表)**: 包含当前页的所有视频信息：   - `aid`: 视频的AV号   - `bvid`: 视频的BV号   - `title`: 视频标题   - `cover`: 封面URL   - `duration`: 时长（秒）   - `play_count`: 播放量   - `publish_time`: 发布时间戳   - `create_time`: 创建时间戳   - `state`: 视频状态   - `is_ugc_pay`: 是否付费视频（0=免费，1=付费）   - `is_interactive`: 是否为互动视频
+     * 获取Bilibili用户投稿列表
+     */
+    async getSocialBilibiliArchives(requestParameters: GetSocialBilibiliArchivesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetSocialBilibiliArchives200Response> {
+        const response = await this.getSocialBilibiliArchivesRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * 想知道你喜欢的主播开播了吗？或者想在你的应用里集成B站直播间状态？这个接口能满足你。  ## 功能概述 这是一个智能接口，你可以用主播的 `mid` (用户ID) 或者直播间的 `room_id` (长号或短号)来查询。它会返回直播间的详细信息，包括是否在直播、标题、封面、人气、分区等。  ## 响应体字段说明 - **`live_status` (直播状态)**: `0` 代表未开播，`1` 代表直播中，`2` 代表轮播中。
+     * 获取Bilibili直播间信息
+     */
+    async getSocialBilibiliLiveroomRaw(requestParameters: GetSocialBilibiliLiveroomRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetSocialBilibiliLiveroom200Response>> {
+        const queryParameters: any = {};
+
+        if (requestParameters['mid'] != null) {
+            queryParameters['mid'] = requestParameters['mid'];
+        }
+
+        if (requestParameters['roomId'] != null) {
+            queryParameters['room_id'] = requestParameters['roomId'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/social/bilibili/liveroom`;
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetSocialBilibiliLiveroom200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 想知道你喜欢的主播开播了吗？或者想在你的应用里集成B站直播间状态？这个接口能满足你。  ## 功能概述 这是一个智能接口，你可以用主播的 `mid` (用户ID) 或者直播间的 `room_id` (长号或短号)来查询。它会返回直播间的详细信息，包括是否在直播、标题、封面、人气、分区等。  ## 响应体字段说明 - **`live_status` (直播状态)**: `0` 代表未开播，`1` 代表直播中，`2` 代表轮播中。
+     * 获取Bilibili直播间信息
+     */
+    async getSocialBilibiliLiveroom(requestParameters: GetSocialBilibiliLiveroomRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetSocialBilibiliLiveroom200Response> {
+        const response = await this.getSocialBilibiliLiveroomRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * 想要分析B站视频的评论区？这个接口可以帮你轻松获取评论数据，包括热门评论和最新评论，还支持分页加载。  ## 功能概述 通过视频的 `oid`（通常就是视频的`aid`），你可以分页获取该视频的评论区内容。你可以指定排序方式和分页参数，来精确地获取你需要的数据。  ## 参数说明 - **`sort` (排序方式)**: `0`=按时间排序, `1`=按点赞数排序, `2`=按回复数排序。默认为按时间排序。  ## 响应体字段说明 - **`hots` (热门评论)**: 仅在请求第一页时，可能会返回热门评论列表。其结构与 `replies` 中的对象一致。 - **`replies` (评论列表)**: 这是一个数组，包含了当前页的评论。其中：   - `root`: 指向根评论的ID。如果评论本身就是根评论，则为 `0`。   - `parent`: 指向该条回复所回复的上一级评论ID。如果评论是根评论，则为 `0`。
+     * 获取Bilibili视频评论
+     */
+    async getSocialBilibiliRepliesRaw(requestParameters: GetSocialBilibiliRepliesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetSocialBilibiliReplies200Response>> {
+        if (requestParameters['oid'] == null) {
+            throw new runtime.RequiredError(
+                'oid',
+                'Required parameter "oid" was null or undefined when calling getSocialBilibiliReplies().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['oid'] != null) {
+            queryParameters['oid'] = requestParameters['oid'];
+        }
+
+        if (requestParameters['sort'] != null) {
+            queryParameters['sort'] = requestParameters['sort'];
+        }
+
+        if (requestParameters['ps'] != null) {
+            queryParameters['ps'] = requestParameters['ps'];
+        }
+
+        if (requestParameters['pn'] != null) {
+            queryParameters['pn'] = requestParameters['pn'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/social/bilibili/replies`;
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetSocialBilibiliReplies200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 想要分析B站视频的评论区？这个接口可以帮你轻松获取评论数据，包括热门评论和最新评论，还支持分页加载。  ## 功能概述 通过视频的 `oid`（通常就是视频的`aid`），你可以分页获取该视频的评论区内容。你可以指定排序方式和分页参数，来精确地获取你需要的数据。  ## 参数说明 - **`sort` (排序方式)**: `0`=按时间排序, `1`=按点赞数排序, `2`=按回复数排序。默认为按时间排序。  ## 响应体字段说明 - **`hots` (热门评论)**: 仅在请求第一页时，可能会返回热门评论列表。其结构与 `replies` 中的对象一致。 - **`replies` (评论列表)**: 这是一个数组，包含了当前页的评论。其中：   - `root`: 指向根评论的ID。如果评论本身就是根评论，则为 `0`。   - `parent`: 指向该条回复所回复的上一级评论ID。如果评论是根评论，则为 `0`。
+     * 获取Bilibili视频评论
+     */
+    async getSocialBilibiliReplies(requestParameters: GetSocialBilibiliRepliesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetSocialBilibiliReplies200Response> {
+        const response = await this.getSocialBilibiliRepliesRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * 想在你的应用里集成B站用户资料展示？这个接口可以轻松获取用户的公开信息。  ## 功能概述 通过一个用户的UID（那一串纯数字ID），你可以查询到该用户的昵称、性别、头像、等级、签名等一系列公开的基本信息。
+     * 查询Bilibili用户信息
+     */
+    async getSocialBilibiliUserinfoRaw(requestParameters: GetSocialBilibiliUserinfoRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetSocialBilibiliUserinfo200Response>> {
+        if (requestParameters['uid'] == null) {
+            throw new runtime.RequiredError(
+                'uid',
+                'Required parameter "uid" was null or undefined when calling getSocialBilibiliUserinfo().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['uid'] != null) {
+            queryParameters['uid'] = requestParameters['uid'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/social/bilibili/userinfo`;
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetSocialBilibiliUserinfo200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 想在你的应用里集成B站用户资料展示？这个接口可以轻松获取用户的公开信息。  ## 功能概述 通过一个用户的UID（那一串纯数字ID），你可以查询到该用户的昵称、性别、头像、等级、签名等一系列公开的基本信息。
+     * 查询Bilibili用户信息
+     */
+    async getSocialBilibiliUserinfo(requestParameters: GetSocialBilibiliUserinfoRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetSocialBilibiliUserinfo200Response> {
+        const response = await this.getSocialBilibiliUserinfoRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * 想在你的应用里展示B站视频的详细信息吗？无论是封面、标题，还是播放量、UP主信息，这个接口都能一网打尽。  ## 功能概述 通过提供视频的 `aid` 或 `bvid`，你可以获取到该视频的完整元数据，包括多P信息、UP主资料、数据统计等。  ## 响应体字段说明 - **`copyright` (视频类型)**: `1` 代表原创，`2` 代表转载。 - **`owner` (UP主信息)**: 包含 `mid`, `name`, `face` 等UP主的基本资料。 - **`stat` (数据统计)**: 包含了播放、弹幕、评论、点赞、投币、收藏、分享等核心数据。 - **`pages` (分P列表)**: 这是一个数组，包含了视频的每一个分P的信息，即使是单P视频也会有一个元素。
+     * 获取Bilibili视频详细信息
+     */
+    async getSocialBilibiliVideoinfoRaw(requestParameters: GetSocialBilibiliVideoinfoRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetSocialBilibiliVideoinfo200Response>> {
+        const queryParameters: any = {};
+
+        if (requestParameters['aid'] != null) {
+            queryParameters['aid'] = requestParameters['aid'];
+        }
+
+        if (requestParameters['bvid'] != null) {
+            queryParameters['bvid'] = requestParameters['bvid'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/social/bilibili/videoinfo`;
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetSocialBilibiliVideoinfo200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 想在你的应用里展示B站视频的详细信息吗？无论是封面、标题，还是播放量、UP主信息，这个接口都能一网打尽。  ## 功能概述 通过提供视频的 `aid` 或 `bvid`，你可以获取到该视频的完整元数据，包括多P信息、UP主资料、数据统计等。  ## 响应体字段说明 - **`copyright` (视频类型)**: `1` 代表原创，`2` 代表转载。 - **`owner` (UP主信息)**: 包含 `mid`, `name`, `face` 等UP主的基本资料。 - **`stat` (数据统计)**: 包含了播放、弹幕、评论、点赞、投币、收藏、分享等核心数据。 - **`pages` (分P列表)**: 这是一个数组，包含了视频的每一个分P的信息，即使是单P视频也会有一个元素。
+     * 获取Bilibili视频详细信息
+     */
+    async getSocialBilibiliVideoinfo(requestParameters: GetSocialBilibiliVideoinfoRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetSocialBilibiliVideoinfo200Response> {
+        const response = await this.getSocialBilibiliVideoinfoRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * 想在你的应用里展示QQ群信息？这个接口让你轻松获取群名称、群头像、群简介等公开信息。它能帮你快速构建社群导航站、群聊推荐系统，或是为你的数据分析工具提供可靠的数据源。无论是展示群聊卡片、生成加群链接，还是进行社群数据统计，这个接口都能满足你的需求。  > [!VIP] > 本API目前处于**限时免费**阶段，我们鼓励开发者集成和测试。未来，它将转为付费API，为用户提供更稳定和强大的服务。  ## 功能概述 你只需要提供一个QQ群号（5-12位纯数字），接口就会返回该群的完整公开信息。我们会先验证群号的有效性，确保返回的数据准确可靠。接口的响应速度快，数据结构清晰，非常适合集成到各类应用场景中。  ## 返回数据说明 接口会返回以下QQ群的关键信息： - **群基础信息**: 包括群号、群名称，让你能够准确识别和展示群聊。 - **视觉素材**: 提供群头像URL（标准100x100尺寸），可直接用于在你的界面中展示群聊图标。 - **群介绍资料**: 包含群描述/简介和群标签，帮助用户了解群聊的主题和特色。 - **便捷入口**: 返回加群链接（二维码URL），方便用户一键加入感兴趣的群聊。 - **数据时效**: 提供最后更新时间戳，让你了解数据的新鲜度。  所有返回的数据都遵循标准的JSON格式，字段命名清晰，便于解析和使用。无论你是在做网页端、移动端还是后端服务，都能轻松集成。
+     * 获取QQ群名称、头像、简介
+     */
+    async getSocialQqGroupinfoRaw(requestParameters: GetSocialQqGroupinfoRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetSocialQqGroupinfo200Response>> {
+        if (requestParameters['groupId'] == null) {
+            throw new runtime.RequiredError(
+                'groupId',
+                'Required parameter "groupId" was null or undefined when calling getSocialQqGroupinfo().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['groupId'] != null) {
+            queryParameters['group_id'] = requestParameters['groupId'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/social/qq/groupinfo`;
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetSocialQqGroupinfo200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 想在你的应用里展示QQ群信息？这个接口让你轻松获取群名称、群头像、群简介等公开信息。它能帮你快速构建社群导航站、群聊推荐系统，或是为你的数据分析工具提供可靠的数据源。无论是展示群聊卡片、生成加群链接，还是进行社群数据统计，这个接口都能满足你的需求。  > [!VIP] > 本API目前处于**限时免费**阶段，我们鼓励开发者集成和测试。未来，它将转为付费API，为用户提供更稳定和强大的服务。  ## 功能概述 你只需要提供一个QQ群号（5-12位纯数字），接口就会返回该群的完整公开信息。我们会先验证群号的有效性，确保返回的数据准确可靠。接口的响应速度快，数据结构清晰，非常适合集成到各类应用场景中。  ## 返回数据说明 接口会返回以下QQ群的关键信息： - **群基础信息**: 包括群号、群名称，让你能够准确识别和展示群聊。 - **视觉素材**: 提供群头像URL（标准100x100尺寸），可直接用于在你的界面中展示群聊图标。 - **群介绍资料**: 包含群描述/简介和群标签，帮助用户了解群聊的主题和特色。 - **便捷入口**: 返回加群链接（二维码URL），方便用户一键加入感兴趣的群聊。 - **数据时效**: 提供最后更新时间戳，让你了解数据的新鲜度。  所有返回的数据都遵循标准的JSON格式，字段命名清晰，便于解析和使用。无论你是在做网页端、移动端还是后端服务，都能轻松集成。
+     * 获取QQ群名称、头像、简介
+     */
+    async getSocialQqGroupinfo(requestParameters: GetSocialQqGroupinfoRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetSocialQqGroupinfo200Response> {
+        const response = await this.getSocialQqGroupinfoRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * 这是一个功能丰富的QQ用户信息查询接口，能够获取QQ用户的详细公开信息。  > [!VIP] > 我们在近日优化了此接口，速度应该会更加快了。   ## 功能概述 通过QQ号查询用户的详细信息，包括基础资料、等级信息、VIP状态等。返回的信息丰富全面，适合用于用户画像分析、社交应用集成等场景。  ## 数据字段说明 - **基础信息**: 昵称、个性签名、头像、年龄、性别 - **联系信息**: QQ邮箱、个性域名(QID) - **等级信息**: QQ等级、VIP状态和等级 - **时间信息**: 注册时间、最后更新时间
+     * 独家获取QQ号头像、昵称
+     */
+    async getSocialQqUserinfoRaw(requestParameters: GetSocialQqUserinfoRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetSocialQqUserinfo200Response>> {
+        if (requestParameters['qq'] == null) {
+            throw new runtime.RequiredError(
+                'qq',
+                'Required parameter "qq" was null or undefined when calling getSocialQqUserinfo().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['qq'] != null) {
+            queryParameters['qq'] = requestParameters['qq'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/social/qq/userinfo`;
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetSocialQqUserinfo200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 这是一个功能丰富的QQ用户信息查询接口，能够获取QQ用户的详细公开信息。  > [!VIP] > 我们在近日优化了此接口，速度应该会更加快了。   ## 功能概述 通过QQ号查询用户的详细信息，包括基础资料、等级信息、VIP状态等。返回的信息丰富全面，适合用于用户画像分析、社交应用集成等场景。  ## 数据字段说明 - **基础信息**: 昵称、个性签名、头像、年龄、性别 - **联系信息**: QQ邮箱、个性域名(QID) - **等级信息**: QQ等级、VIP状态和等级 - **时间信息**: 注册时间、最后更新时间
+     * 独家获取QQ号头像、昵称
+     */
+    async getSocialQqUserinfo(requestParameters: GetSocialQqUserinfoRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetSocialQqUserinfo200Response> {
+        const response = await this.getSocialQqUserinfoRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+}

package/internal/src/apis/StatusApi.ts

@@ -0,0 +1,127 @@
+/* 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 {
+  GetStatusRatelimit200Response,
+  GetStatusRatelimit401Response,
+  GetStatusUsage200Response,
+  GetStatusUsage404Response,
+  GetStatusUsage500Response,
+} from '../models/index';
+import {
+    GetStatusRatelimit200ResponseFromJSON,
+    GetStatusRatelimit200ResponseToJSON,
+    GetStatusRatelimit401ResponseFromJSON,
+    GetStatusRatelimit401ResponseToJSON,
+    GetStatusUsage200ResponseFromJSON,
+    GetStatusUsage200ResponseToJSON,
+    GetStatusUsage404ResponseFromJSON,
+    GetStatusUsage404ResponseToJSON,
+    GetStatusUsage500ResponseFromJSON,
+    GetStatusUsage500ResponseToJSON,
+} from '../models/index';
+
+export interface GetStatusRatelimitRequest {
+    authorization: string;
+}
+
+export interface GetStatusUsageRequest {
+    path?: string;
+}
+
+/**
+ * 
+ */
+export class StatusApi extends runtime.BaseAPI {
+
+    /**
+     * 想了解我们API的当前负载情况吗？这个接口为你提供了服务的“心电图”。  ## 功能概述 此接口返回我们后端自适应限流器的实时状态。你可以看到当前并发请求数、并发上限、系统负载、请求接受/拒绝数等核心指标。这对于监控API健康状况和性能表现至关重要。  > [!IMPORTANT] > 此接口为管理接口，需要提供有效的管理员级别API密钥才能访问。  ### 认证方式 请在请求头中添加 `Authorization: Bearer <你的API密钥>`。
+     * 获取API限流器实时状态
+     */
+    async getStatusRatelimitRaw(requestParameters: GetStatusRatelimitRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetStatusRatelimit200Response>> {
+        if (requestParameters['authorization'] == null) {
+            throw new runtime.RequiredError(
+                'authorization',
+                'Required parameter "authorization" was null or undefined when calling getStatusRatelimit().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (requestParameters['authorization'] != null) {
+            headerParameters['Authorization'] = String(requestParameters['authorization']);
+        }
+
+
+        let urlPath = `/status/ratelimit`;
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetStatusRatelimit200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 想了解我们API的当前负载情况吗？这个接口为你提供了服务的“心电图”。  ## 功能概述 此接口返回我们后端自适应限流器的实时状态。你可以看到当前并发请求数、并发上限、系统负载、请求接受/拒绝数等核心指标。这对于监控API健康状况和性能表现至关重要。  > [!IMPORTANT] > 此接口为管理接口，需要提供有效的管理员级别API密钥才能访问。  ### 认证方式 请在请求头中添加 `Authorization: Bearer <你的API密钥>`。
+     * 获取API限流器实时状态
+     */
+    async getStatusRatelimit(requestParameters: GetStatusRatelimitRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetStatusRatelimit200Response> {
+        const response = await this.getStatusRatelimitRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * 想知道哪个API接口最受欢迎吗？这个接口提供了详细的“账单”。  ## 功能概述 此接口用于获取每个API端点（Endpoint）的使用情况统计。你可以查询所有端点的列表，也可以通过 `path` 参数指定查询某一个特定端点。返回信息包括调用次数和平均处理时长
+     * 获取API端点使用统计
+     */
+    async getStatusUsageRaw(requestParameters: GetStatusUsageRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetStatusUsage200Response>> {
+        const queryParameters: any = {};
+
+        if (requestParameters['path'] != null) {
+            queryParameters['path'] = requestParameters['path'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/status/usage`;
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetStatusUsage200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 想知道哪个API接口最受欢迎吗？这个接口提供了详细的“账单”。  ## 功能概述 此接口用于获取每个API端点（Endpoint）的使用情况统计。你可以查询所有端点的列表，也可以通过 `path` 参数指定查询某一个特定端点。返回信息包括调用次数和平均处理时长
+     * 获取API端点使用统计
+     */
+    async getStatusUsage(requestParameters: GetStatusUsageRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetStatusUsage200Response> {
+        const response = await this.getStatusUsageRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+}