uapi-browser-sdk 0.1.4 → 0.1.12

package/internal/docs/MiscApi.md

@@ -4,17 +4,21 @@ All URIs are relative to *https://uapis.cn/api/v1*
 
 | Method | HTTP request | Description |
 |------------- | ------------- | -------------|
-| [**getHistoryProgrammer**](MiscApi.md#gethistoryprogrammer) | **GET** /history/programmer | 获取指定日期的程序员历史事件 |
-| [**getHistoryProgrammerToday**](MiscApi.md#gethistoryprogrammertoday) | **GET** /history/programmer/today | 获取今天的程序员历史事件 |
-| [**getMiscHotboard**](MiscApi.md#getmischotboard) | **GET** /misc/hotboard | 获取多平台实时热榜 |
-| [**getMiscPhoneinfo**](MiscApi.md#getmiscphoneinfo) | **GET** /misc/phoneinfo | 查询手机号码归属地信息 |
-| [**getMiscRandomnumber**](MiscApi.md#getmiscrandomnumber) | **GET** /misc/randomnumber | 生成高度可定制的随机数 |
+| [**getHistoryProgrammer**](MiscApi.md#gethistoryprogrammer) | **GET** /history/programmer | 程序员历史事件 |
+| [**getHistoryProgrammerToday**](MiscApi.md#gethistoryprogrammertoday) | **GET** /history/programmer/today | 程序员历史上的今天 |
+| [**getMiscDistrict**](MiscApi.md#getmiscdistrict) | **GET** /misc/district | Adcode 国内外行政区域查询 |
+| [**getMiscHolidayCalendar**](MiscApi.md#getmischolidaycalendar) | **GET** /misc/holiday-calendar | 查询节假日与万年历 |
+| [**getMiscHotboard**](MiscApi.md#getmischotboard) | **GET** /misc/hotboard | 查询热榜 |
+| [**getMiscLunartime**](MiscApi.md#getmisclunartime) | **GET** /misc/lunartime | 查询农历时间 |
+| [**getMiscPhoneinfo**](MiscApi.md#getmiscphoneinfo) | **GET** /misc/phoneinfo | 查询手机归属地 |
+| [**getMiscRandomnumber**](MiscApi.md#getmiscrandomnumber) | **GET** /misc/randomnumber | 随机数生成 |
 | [**getMiscTimestamp**](MiscApi.md#getmisctimestamp) | **GET** /misc/timestamp | 转换时间戳 (旧版，推荐使用/convert/unixtime) |
 | [**getMiscTrackingCarriers**](MiscApi.md#getmisctrackingcarriers) | **GET** /misc/tracking/carriers | 获取支持的快递公司列表 |
 | [**getMiscTrackingDetect**](MiscApi.md#getmisctrackingdetect) | **GET** /misc/tracking/detect | 识别快递公司 |
 | [**getMiscTrackingQuery**](MiscApi.md#getmisctrackingquery) | **GET** /misc/tracking/query | 查询快递物流信息 |
-| [**getMiscWeather**](MiscApi.md#getmiscweather) | **GET** /misc/weather | 查询实时天气信息 |
-| [**getMiscWorldtime**](MiscApi.md#getmiscworldtime) | **GET** /misc/worldtime | 查询全球任意时区的时间 |
+| [**getMiscWeather**](MiscApi.md#getmiscweather) | **GET** /misc/weather | 查询天气 |
+| [**getMiscWorldtime**](MiscApi.md#getmiscworldtime) | **GET** /misc/worldtime | 查询世界时间 |
+| [**postMiscDateDiff**](MiscApi.md#postmiscdatediffoperation) | **POST** /misc/date-diff | 计算两个日期之间的时间差值 |
 
 
 
@@ -22,7 +26,7 @@ All URIs are relative to *https://uapis.cn/api/v1*
 
 > GetHistoryProgrammer200Response getHistoryProgrammer(month, day)
 
-获取指定日期的程序员历史事件
+程序员历史事件
 
 想查看程序员历史上某个特定日期发生的大事件？指定月份和日期，我们就能告诉你！  ## 功能概述 通过指定月份和日期，获取该日发生的程序员相关历史事件。同样使用AI智能筛选，确保事件的相关性和重要性。
 
@@ -94,7 +98,7 @@ No authorization required
 
 > GetHistoryProgrammerToday200Response getHistoryProgrammerToday()
 
-获取今天的程序员历史事件
+程序员历史上的今天
 
 想知道程序员历史上的今天发生了什么大事吗？这个接口告诉你答案！  ## 功能概述 我们使用AI智能筛选从海量历史事件中挑选出与程序员、计算机科学相关的重要事件。每个事件都经过重要性评分和相关性评分，确保内容质量。
 
@@ -150,13 +154,185 @@ No authorization required
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
+## getMiscDistrict
+
+> GetMiscDistrict200Response getMiscDistrict(keywords, adcode, lat, lng, level, country, limit)
+
+Adcode 国内外行政区域查询
+
+一个接口，覆盖全球 243 个国家、中国省/市/区/街道四级行政区划，支持关键词搜索、行政编码查询、坐标反查三种查询模式（必须至少传入一种查询参数）。  ## 功能概述 根据用户输入的搜索条件快速查找行政区域信息。例如：中国 > 山东省 > 济南市 > 历下区 > 舜华路街道。  无需注册、无需密钥，直接调用即可获取结构化的行政区域数据。支持三种查询方式： - 传 `adcode`，按行政编码精确查询，同时返回下级区划列表 - 传 `lat` + `lng`，坐标反查附近地点 - 传 `keywords`，按关键词搜索，支持中英文  ## 中国与国际数据差异 中国数据包含 `adcode`、`citycode` 等字段，支持省/市/区/街道四级逐级查询；国际城市数据不含这些字段，但额外提供 `population`（人口）和 `timezone`（时区）。  > [!NOTE] > 部分城市（如东莞、文昌）没有区县层级，市级下方直接显示街道。街道级别的 `adcode` 返回的是所属区县的 `adcode`。
+
+### Example
+
+```ts
+import {
+  Configuration,
+  MiscApi,
+} from 'uapi-browser-sdk-browser';
+import type { GetMiscDistrictRequest } from 'uapi-browser-sdk-browser';
+
+async function example() {
+  console.log("🚀 Testing uapi-browser-sdk-browser SDK...");
+  const api = new MiscApi();
+
+  const body = {
+    // string | 关键词搜索（城市名、区县名，支持中英文）。 (optional)
+    keywords: 上海,
+    // string | 中国行政区划代码精确查询（如 `110000`），同时返回下级行政区。 (optional)
+    adcode: 110000,
+    // number | 纬度，与 `lng` 配合使用，坐标反查附近地点。 (optional)
+    lat: 39.9,
+    // number | 经度，与 `lat` 配合使用。 (optional)
+    lng: 116.4,
+    // 'province' | 'city' | 'district' | 'street' | 过滤行政级别。 (optional)
+    level: level_example,
+    // string | 过滤国家代码（ISO 3166-1 alpha-2），如 `CN`、`JP`、`US`、`GB`。 (optional)
+    country: CN,
+    // number | 返回数量上限，默认 `20`，最大 `100`。 (optional)
+    limit: 20,
+  } satisfies GetMiscDistrictRequest;
+
+  try {
+    const data = await api.getMiscDistrict(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **keywords** | `string` | 关键词搜索（城市名、区县名，支持中英文）。 | [Optional] [Defaults to `undefined`] |
+| **adcode** | `string` | 中国行政区划代码精确查询（如 `110000`），同时返回下级行政区。 | [Optional] [Defaults to `undefined`] |
+| **lat** | `number` | 纬度，与 `lng` 配合使用，坐标反查附近地点。 | [Optional] [Defaults to `undefined`] |
+| **lng** | `number` | 经度，与 `lat` 配合使用。 | [Optional] [Defaults to `undefined`] |
+| **level** | `province`, `city`, `district`, `street` | 过滤行政级别。 | [Optional] [Defaults to `undefined`] [Enum: province, city, district, street] |
+| **country** | `string` | 过滤国家代码（ISO 3166-1 alpha-2），如 `CN`、`JP`、`US`、`GB`。 | [Optional] [Defaults to `undefined`] |
+| **limit** | `number` | 返回数量上限，默认 `20`，最大 `100`。 | [Optional] [Defaults to `20`] |
+
+### Return type
+
+[**GetMiscDistrict200Response**](GetMiscDistrict200Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | 查询成功！返回匹配的行政区域列表。 |  -  |
+| **400** | 请求参数错误。 |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## getMiscHolidayCalendar
+
+> GetMiscHolidayCalendar200Response getMiscHolidayCalendar(date, month, year, timezone, holidayType, includeNearby, nearbyLimit)
+
+查询节假日与万年历
+
+查询指定日期、月份或年份的万年历与节假日信息。  ## 功能概述 这个接口支持三种查询方式：按天（`date`）、按月（`month`）和按年（`year`）。调用时三者选一个传入即可。  如果你只关心某一类事件，可以通过 `holiday_type` 进行筛选，例如只看法定休假/调休、公历节日、农历节日或节气。  在 `date` 模式下，传 `include_nearby=true` 可以额外返回该日期前后最近的节日；返回数量由 `nearby_limit` 控制，默认 7，最大 30。
+
+### Example
+
+```ts
+import {
+  Configuration,
+  MiscApi,
+} from 'uapi-browser-sdk-browser';
+import type { GetMiscHolidayCalendarRequest } from 'uapi-browser-sdk-browser';
+
+async function example() {
+  console.log("🚀 Testing uapi-browser-sdk-browser SDK...");
+  const api = new MiscApi();
+
+  const body = {
+    // string | 按天查询时填写这个参数，例如查某一天。格式：`YYYY-MM-DD`。和 `month`、`year` 三选一。 (optional)
+    date: 2025-10-01,
+    // string | 按月查询时填写这个参数，例如查某个月。格式：`YYYY-MM`。和 `date`、`year` 三选一。 (optional)
+    month: month_example,
+    // string | 按年查询时填写这个参数，例如查某一年。格式：`YYYY`。和 `date`、`month` 三选一。 (optional)
+    year: year_example,
+    // string | 时区名称，默认 Asia/Shanghai。 (optional)
+    timezone: Asia/Shanghai,
+    // 'all' | 'legal' | 'legal_rest' | 'legal_workday' | 'solar' | 'lunar' | 'term' | 节日筛选类型，默认 all。 (optional)
+    holidayType: legal,
+    // boolean | 是否返回前后最近节日，仅 date 模式生效，默认 false。month/year 模式会忽略此参数。 (optional)
+    includeNearby: true,
+    // number | 返回最近节日数量限制，默认 7，最大 30。仅 date 模式 + include_nearby=true 生效。 (optional)
+    nearbyLimit: 7,
+  } satisfies GetMiscHolidayCalendarRequest;
+
+  try {
+    const data = await api.getMiscHolidayCalendar(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **date** | `string` | 按天查询时填写这个参数，例如查某一天。格式：`YYYY-MM-DD`。和 `month`、`year` 三选一。 | [Optional] [Defaults to `undefined`] |
+| **month** | `string` | 按月查询时填写这个参数，例如查某个月。格式：`YYYY-MM`。和 `date`、`year` 三选一。 | [Optional] [Defaults to `undefined`] |
+| **year** | `string` | 按年查询时填写这个参数，例如查某一年。格式：`YYYY`。和 `date`、`month` 三选一。 | [Optional] [Defaults to `undefined`] |
+| **timezone** | `string` | 时区名称，默认 Asia/Shanghai。 | [Optional] [Defaults to `'Asia/Shanghai'`] |
+| **holidayType** | `all`, `legal`, `legal_rest`, `legal_workday`, `solar`, `lunar`, `term` | 节日筛选类型，默认 all。 | [Optional] [Defaults to `'all'`] [Enum: all, legal, legal_rest, legal_workday, solar, lunar, term] |
+| **includeNearby** | `boolean` | 是否返回前后最近节日，仅 date 模式生效，默认 false。month/year 模式会忽略此参数。 | [Optional] [Defaults to `false`] |
+| **nearbyLimit** | `number` | 返回最近节日数量限制，默认 7，最大 30。仅 date 模式 + include_nearby=true 生效。 | [Optional] [Defaults to `7`] |
+
+### Return type
+
+[**GetMiscHolidayCalendar200Response**](GetMiscHolidayCalendar200Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | 查询成功，返回指定范围的万年历与节假日信息。 |  -  |
+| **400** | 请求参数错误。常见原因： - `date`、`month`、`year` 未传或同时传入多个 - 日期格式错误：`date` 必须为 `YYYY-MM-DD`、`month` 必须为 `YYYY-MM`、`year` 必须为 `YYYY` - `holiday_type` 非法 - `timezone` 非法 |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
 ## getMiscHotboard
 
-> GetMiscHotboard200Response getMiscHotboard(type)
+> GetMiscHotboard200Response getMiscHotboard(type, time, keyword, timeStart, timeEnd, limit, sources)
 
-获取多平台实时热榜
+查询热榜
 
-想快速跟上网络热点？这个接口让你一网打尽各大主流平台的实时热榜/热搜！  ## 功能概述 你只需要指定一个平台类型，就能获取到该平台当前的热榜数据列表。每个热榜条目都包含标题、热度值和原始链接。非常适合用于制作信息聚合类应用或看板。  ## 可选值 `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（历史上的今天） | 
+想快速跟上网络热点？这个接口让你一网打尽各大主流平台的实时热榜/热搜！  ## 功能概述 你只需要指定一个平台类型，就能获取到该平台当前的热榜数据列表。每个热榜条目都包含标题、热度值和原始链接。非常适合用于制作信息聚合类应用或看板。  ## 三种使用模式  ### 默认模式 只传 `type` 参数，返回该平台当前的实时热榜。  ### 时光机模式 传 `type` + `time` 参数，返回最接近指定时间的热榜快照。如果不可用或无数据，会返回空。  ### 搜索模式 传 `type` + `keyword` + `time_start` + `time_end` 参数，在指定时间范围内搜索包含关键词的热榜条目。可选传 `limit` 限制返回数量。  ### 数据源列表 传 `sources=true`，返回所有支持历史数据的平台列表。
 
 ### Example
 
@@ -172,8 +348,20 @@ async function example() {
   const api = new MiscApi();
 
   const body = {
-    // 'bilibili' | 'acfun' | 'weibo' | 'zhihu' | 'zhihu-daily' | 'douyin' | 'kuaishou' | 'douban-movie' | 'douban-group' | 'tieba' | 'hupu' | 'miyoushe' | 'ngabbs' | 'v2ex' | '52pojie' | 'hostloc' | 'coolapk' | 'baidu' | 'thepaper' | 'toutiao' | 'qq-news' | 'sina' | 'sina-news' | 'netease-news' | 'huxiu' | 'ifanr' | 'sspai' | 'ithome' | 'ithome-xijiayi' | 'juejin' | 'jianshu' | 'guokr' | '36kr' | '51cto' | 'csdn' | 'nodeseek' | 'hellogithub' | 'lol' | 'genshin' | 'honkai' | 'starrail' | 'weread' | 'weatheralarm' | 'earthquake' | 'history' | 你想要查询的热榜平台。支持多种主流平台类型，详见下方[可选值](#可选值)表格。
+    // 'bilibili' | 'acfun' | 'weibo' | 'zhihu' | 'zhihu-daily' | 'douyin' | 'kuaishou' | 'douban-movie' | 'douban-group' | 'tieba' | 'hupu' | 'ngabbs' | 'v2ex' | '52pojie' | 'hostloc' | 'coolapk' | 'baidu' | 'thepaper' | 'toutiao' | 'qq-news' | 'sina' | 'sina-news' | 'netease-news' | 'huxiu' | 'ifanr' | 'sspai' | 'ithome' | 'ithome-xijiayi' | 'juejin' | 'jianshu' | 'guokr' | '36kr' | '51cto' | 'csdn' | 'nodeseek' | 'hellogithub' | 'lol' | 'genshin' | 'honkai' | 'starrail' | 'netease-music' | 'qq-music' | 'weread' | 'weatheralarm' | 'earthquake' | 'history' | 你想要查询的热榜平台。请从[支持的平台列表](#enum-list)中选择。
     type: weibo,
+    // number | 时光机模式：毫秒时间戳，返回最接近该时间的热榜快照。不传则返回当前实时热榜。 (optional)
+    time: 789,
+    // string | 搜索模式：搜索关键词，在历史热榜中搜索包含该关键词的条目。需配合 time_start 和 time_end 使用。 (optional)
+    keyword: keyword_example,
+    // number | 搜索模式必填：搜索起始时间戳（毫秒）。 (optional)
+    timeStart: 789,
+    // number | 搜索模式必填：搜索结束时间戳（毫秒）。 (optional)
+    timeEnd: 789,
+    // number | 搜索模式下最大返回条数，默认 50，最大 200。 (optional)
+    limit: 56,
+    // boolean | 设为 true 时列出所有可用的历史数据源，忽略其他参数。 (optional)
+    sources: true,
   } satisfies GetMiscHotboardRequest;
 
   try {
@@ -193,7 +381,13 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **type** | `bilibili`, `acfun`, `weibo`, `zhihu`, `zhihu-daily`, `douyin`, `kuaishou`, `douban-movie`, `douban-group`, `tieba`, `hupu`, `miyoushe`, `ngabbs`, `v2ex`, `52pojie`, `hostloc`, `coolapk`, `baidu`, `thepaper`, `toutiao`, `qq-news`, `sina`, `sina-news`, `netease-news`, `huxiu`, `ifanr`, `sspai`, `ithome`, `ithome-xijiayi`, `juejin`, `jianshu`, `guokr`, `36kr`, `51cto`, `csdn`, `nodeseek`, `hellogithub`, `lol`, `genshin`, `honkai`, `starrail`, `weread`, `weatheralarm`, `earthquake`, `history` | 你想要查询的热榜平台。支持多种主流平台类型，详见下方[可选值](#可选值)表格。 | [Defaults to `undefined`] [Enum: bilibili, acfun, weibo, zhihu, zhihu-daily, douyin, kuaishou, douban-movie, douban-group, tieba, hupu, miyoushe, ngabbs, v2ex, 52pojie, hostloc, coolapk, baidu, thepaper, toutiao, qq-news, sina, sina-news, netease-news, huxiu, ifanr, sspai, ithome, ithome-xijiayi, juejin, jianshu, guokr, 36kr, 51cto, csdn, nodeseek, hellogithub, lol, genshin, honkai, starrail, weread, weatheralarm, earthquake, history] |
+| **type** | `bilibili`, `acfun`, `weibo`, `zhihu`, `zhihu-daily`, `douyin`, `kuaishou`, `douban-movie`, `douban-group`, `tieba`, `hupu`, `ngabbs`, `v2ex`, `52pojie`, `hostloc`, `coolapk`, `baidu`, `thepaper`, `toutiao`, `qq-news`, `sina`, `sina-news`, `netease-news`, `huxiu`, `ifanr`, `sspai`, `ithome`, `ithome-xijiayi`, `juejin`, `jianshu`, `guokr`, `36kr`, `51cto`, `csdn`, `nodeseek`, `hellogithub`, `lol`, `genshin`, `honkai`, `starrail`, `netease-music`, `qq-music`, `weread`, `weatheralarm`, `earthquake`, `history` | 你想要查询的热榜平台。请从[支持的平台列表](#enum-list)中选择。 | [Defaults to `undefined`] [Enum: bilibili, acfun, weibo, zhihu, zhihu-daily, douyin, kuaishou, douban-movie, douban-group, tieba, hupu, ngabbs, v2ex, 52pojie, hostloc, coolapk, baidu, thepaper, toutiao, qq-news, sina, sina-news, netease-news, huxiu, ifanr, sspai, ithome, ithome-xijiayi, juejin, jianshu, guokr, 36kr, 51cto, csdn, nodeseek, hellogithub, lol, genshin, honkai, starrail, netease-music, qq-music, weread, weatheralarm, earthquake, history] |
+| **time** | `number` | 时光机模式：毫秒时间戳，返回最接近该时间的热榜快照。不传则返回当前实时热榜。 | [Optional] [Defaults to `undefined`] |
+| **keyword** | `string` | 搜索模式：搜索关键词，在历史热榜中搜索包含该关键词的条目。需配合 time_start 和 time_end 使用。 | [Optional] [Defaults to `undefined`] |
+| **timeStart** | `number` | 搜索模式必填：搜索起始时间戳（毫秒）。 | [Optional] [Defaults to `undefined`] |
+| **timeEnd** | `number` | 搜索模式必填：搜索结束时间戳（毫秒）。 | [Optional] [Defaults to `undefined`] |
+| **limit** | `number` | 搜索模式下最大返回条数，默认 50，最大 200。 | [Optional] [Defaults to `undefined`] |
+| **sources** | `boolean` | 设为 true 时列出所有可用的历史数据源，忽略其他参数。 | [Optional] [Defaults to `undefined`] |
 
 ### Return type
 
@@ -212,7 +406,7 @@ No authorization required
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** | 查询成功！返回指定平台的热榜列表数据。 |  -  |
+| **200** | 查询成功！返回指定平台的热榜列表数据。不同模式返回格式不同：默认模式和时光机模式返回 list 数组；搜索模式返回 results 数组；数据源列表模式返回 sources 数组。 |  -  |
 | **400** | 请求参数错误。你提供的 `type` 参数不是我们支持的平台类型，请检查拼写。 |  -  |
 | **500** | 获取热榜失败。服务器在处理数据时发生内部错误。 |  -  |
 | **502** | 上游服务错误。我们从目标平台（如微博）获取数据时失败，可能是对方接口暂时不可用或有反爬策略。 |  -  |
@@ -220,11 +414,82 @@ No authorization required
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
+## getMiscLunartime
+
+> GetMiscLunartime200Response getMiscLunartime(ts, timezone)
+
+查询农历时间
+
+需要在指定时区下查看某个时间点的农历信息？这个接口可以直接返回完整结果。  ## 功能概述 支持传入 Unix 时间戳（秒或毫秒）和 IANA 时区名，返回公历时间、星期、农历年月日、干支、生肖、节气与节日信息。不传 `ts` 时默认使用当前时间，不传 `timezone` 时默认 `Asia/Shanghai`。  ## 时区说明 - 支持标准 IANA 时区，例如 `Asia/Shanghai`、`Asia/Tokyo` - 也支持别名：`Shanghai`、`Beijing` - 时区非法时返回 400 并提示 `invalid timezone: xxx`
+
+### Example
+
+```ts
+import {
+  Configuration,
+  MiscApi,
+} from 'uapi-browser-sdk-browser';
+import type { GetMiscLunartimeRequest } from 'uapi-browser-sdk-browser';
+
+async function example() {
+  console.log("🚀 Testing uapi-browser-sdk-browser SDK...");
+  const api = new MiscApi();
+
+  const body = {
+    // string | Unix 时间戳，支持 10 位秒级或 13 位毫秒级。不传则默认当前时间。 (optional)
+    ts: 1707537600,
+    // string | 时区名称。支持 IANA 时区（如 Asia/Shanghai）和别名（Shanghai、Beijing）。默认 Asia/Shanghai。 (optional)
+    timezone: Asia/Shanghai,
+  } satisfies GetMiscLunartimeRequest;
+
+  try {
+    const data = await api.getMiscLunartime(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **ts** | `string` | Unix 时间戳，支持 10 位秒级或 13 位毫秒级。不传则默认当前时间。 | [Optional] [Defaults to `undefined`] |
+| **timezone** | `string` | 时区名称。支持 IANA 时区（如 Asia/Shanghai）和别名（Shanghai、Beijing）。默认 Asia/Shanghai。 | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**GetMiscLunartime200Response**](GetMiscLunartime200Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | 查询成功，返回指定时间和时区下的农历信息。 |  -  |
+| **400** | 请求参数错误。`timezone` 非法时返回 `invalid timezone: xxx`，`ts` 非法时返回 `invalid timestamp: xxx`。 |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
 ## getMiscPhoneinfo
 
 > GetMiscPhoneinfo200Response getMiscPhoneinfo(phone)
 
-查询手机号码归属地信息
+查询手机归属地
 
 想知道一个手机号码来自哪里？是移动、联通还是电信？这个接口可以告诉你答案。  ## 功能概述 提供一个国内的手机号码，我们会查询并返回它的归属地（省份和城市）以及所属的运营商信息。
 
@@ -293,7 +558,7 @@ No authorization required
 
 > GetMiscRandomnumber200Response getMiscRandomnumber(min, max, count, allowRepeat, allowDecimal, decimalPlaces)
 
-生成高度可定制的随机数
+随机数生成
 
 需要一个简单的随机数，还是需要一串不重复的、带小数的随机数？这个接口都能满足你！  ## 功能概述 这是一个强大的随机数生成器。你可以指定生成的范围（最大/最小值）、数量、是否允许重复、以及是否生成小数（并指定小数位数）。  ## 流程图 ```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 错误。
 
@@ -378,7 +643,7 @@ No authorization required
 
 转换时间戳 (旧版，推荐使用/convert/unixtime)
 
-这是一个用于将Unix时间戳转换为人类可读日期时间的旧版接口。  ## 功能概述 输入一个秒级或毫秒级的时间戳，返回其对应的本地时间和UTC时间。  > [!WARNING] > **接口已过时**：这个接口已被新的 `/convert/unixtime` 取代。新接口功能更强大，支持双向转换。我们建议你迁移到新接口。  [👉 前往新版接口文档](/docs/api-reference/get-convert-unixtime)
+这是一个用于将Unix时间戳转换为人类可读日期时间的旧版接口。  ## 功能概述 输入一个秒级或毫秒级的时间戳，返回其对应的本地时间和UTC时间。  > [!WARNING] > **接口已过时**：这个接口已被新的 `/convert/unixtime` 取代。新接口功能更强大，支持双向转换。我们建议你迁移到新接口。  [➡️ 前往新版接口文档](/docs/api-reference/get-convert-unixtime)
 
 ### Example
 
@@ -446,7 +711,7 @@ No authorization required
 
 获取支持的快递公司列表
 
-不确定系统支持哪些快递公司？这个接口返回完整的支持列表。  > [!VIP] > 本API目前处于**限时免费**阶段，我们鼓励开发者集成和测试。未来，它将转为付费API，为用户提供更稳定和强大的服务。  ## 功能概述 获取系统当前支持的所有快递公司列表，包括每家公司的标准编码（code）和中文名称（name）。  ## 使用建议 - **推荐缓存**：这个列表基本不会频繁变动，建议在应用启动时调用一次并缓存到本地 - **应用场景**：适合用于构建快递公司选择器、下拉菜单等UI组件 - **缓存时长**：建议缓存24小时或更久
+不确定系统支持哪些快递公司？这个接口返回完整的支持列表。  ## 功能概述 获取系统当前支持的所有快递公司列表，包括每家公司的标准编码（code）和中文名称（name）。  ## 使用建议 - **推荐缓存**：这个列表基本不会频繁变动，建议在应用启动时调用一次并缓存到本地 - **应用场景**：适合用于构建快递公司选择器、下拉菜单等UI组件 - **缓存时长**：建议缓存24小时或更久
 
 ### Example
 
@@ -505,7 +770,7 @@ No authorization required
 
 识别快递公司
 
-不确定手里的快递单号属于哪家快递公司？这个接口专门做识别，不查物流。  > [!VIP] > 本API目前处于**限时免费**阶段，我们鼓励开发者集成和测试。未来，它将转为付费API，为用户提供更稳定和强大的服务。  ## 功能概述 输入快递单号，系统会根据单号规则快速识别出最可能的快递公司。如果存在多个可能的匹配结果，还会在 `alternatives` 字段中返回备选项，供你参考选择。  ## 使用须知 - **识别速度快**：只做规则匹配，不查询物流信息，响应速度通常在100ms内 - **准确率高**：基于各快递公司的单号规则进行智能识别，准确率超过95% - **备选方案**：当单号规则可能匹配多家快递公司时，会提供所有可能的选项
+不确定手里的快递单号属于哪家快递公司？这个接口专门做识别，不查物流。  ## 功能概述 输入快递单号，系统会根据单号规则快速识别出最可能的快递公司。如果存在多个可能的匹配结果，还会在 `alternatives` 字段中返回备选项，供你参考选择。  ## 使用须知 - **识别速度快**：只做规则匹配，不查询物流信息，响应速度通常在100ms内 - **准确率高**：基于各快递公司的单号规则进行智能识别，准确率超过95% - **备选方案**：当单号规则可能匹配多家快递公司时，会提供所有可能的选项
 
 ### Example
 
@@ -561,7 +826,7 @@ No authorization required
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** | 识别成功！返回识别结果和可能的备选项。 |  -  |
+| **200** | 识别成功！直接返回识别结果和可能的备选项。 |  -  |
 | **404** | 无法识别该快递单号。 |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
@@ -569,11 +834,11 @@ No authorization required
 
 ## getMiscTrackingQuery
 
-> GetMiscTrackingQuery200Response getMiscTrackingQuery(trackingNumber, carrierCode)
+> GetMiscTrackingQuery200Response getMiscTrackingQuery(trackingNumber, carrierCode, phone)
 
 查询快递物流信息
 
-买了东西想知道快递到哪儿了？这个接口帮你实时追踪物流状态。  > [!VIP] > 本API目前处于**限时免费**阶段，我们鼓励开发者集成和测试。未来，它将转为付费API，为用户提供更稳定和强大的服务。  ## 功能概述 提供一个快递单号，系统会自动识别快递公司并返回完整的物流轨迹信息。支持中通、圆通、韵达、申通、极兔、顺丰、京东、EMS、德邦等60+国内外主流快递公司。  ## 使用须知 - **自动识别**：不知道是哪家快递？系统会根据单号规则自动识别快递公司（推荐使用） - **手动指定**：如果已知快递公司，可以传递 `carrier_code` 参数，查询速度会更快 - **查询时效**：物流信息实时查询，响应时间通常在1-2秒内
+买了东西想知道快递到哪儿了？这个接口帮你实时追踪物流状态。  ## 功能概述 提供一个快递单号，系统会自动识别快递公司并返回完整的物流轨迹信息。这个接口目前可以查询中通、圆通、韵达、申通、极兔、京东、EMS、德邦等主流快递公司的物流信息。  ## 使用须知 目前暂不支持顺丰快递单号的物流查询。  - **自动识别**：不知道是哪家快递？系统会根据单号规则自动识别快递公司（推荐使用） - **手动指定**：如果已知快递公司，可以传递 `carrier_code` 参数，查询速度会更快 - **手机尾号验证**：部分快递公司需要验证收件人手机尾号才能查询详细物流，如果返回 `暂无物流信息`，建议尝试传入 `phone` 参数 - **查询时效**：物流信息实时查询，响应时间通常在1-2秒内
 
 ### Example
 
@@ -590,9 +855,11 @@ async function example() {
 
   const body = {
     // string | 快递单号，通常是一串10-20位的数字或字母数字组合。
-    trackingNumber: trackingNumber_example,
+    trackingNumber: YT1234567890123,
     // string | 快递公司编码（可选）。不填写时系统会自动识别，填写后可加快查询速度。 (optional)
     carrierCode: carrierCode_example,
+    // string | 收件人手机尾号，4位数字（可选）。部分快递公司需要验证手机尾号才能查询详细物流信息。 (optional)
+    phone: phone_example,
   } satisfies GetMiscTrackingQueryRequest;
 
   try {
@@ -614,6 +881,7 @@ example().catch(console.error);
 |------------- | ------------- | ------------- | -------------|
 | **trackingNumber** | `string` | 快递单号，通常是一串10-20位的数字或字母数字组合。 | [Defaults to `undefined`] |
 | **carrierCode** | `string` | 快递公司编码（可选）。不填写时系统会自动识别，填写后可加快查询速度。 | [Optional] [Defaults to `undefined`] |
+| **phone** | `string` | 收件人手机尾号，4位数字（可选）。部分快递公司需要验证手机尾号才能查询详细物流信息。 | [Optional] [Defaults to `undefined`] |
 
 ### Return type
 
@@ -632,20 +900,20 @@ No authorization required
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** | 查询成功！返回快递的完整物流轨迹。 |  -  |
+| **200** | 查询成功！直接返回快递的完整物流轨迹。 |  -  |
 | **400** | 参数错误，请检查快递单号是否正确。 |  -  |
-| **404** | 当前没有查询到物流轨迹时会返回 404，并附带错误码和提示信息。 |  -  |
+| **404** | 当前没有查询到物流轨迹时会返回 404，并附带错误码和提示信息。如果返回此错误，建议尝试传入 `phone` 参数（收件人手机尾号）再次查询。 |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
 ## getMiscWeather
 
-> GetMiscWeather200Response getMiscWeather(city, adcode)
+> GetMiscWeather200Response getMiscWeather(city, adcode, extended, forecast, hourly, minutely, indices, lang)
 
-查询实时天气信息
+查询天气
 
-出门前，查一下天气总是个好习惯。这个接口为你提供精准、实时的天气数据。  ## 功能概述 你可以通过城市名称或高德地图的Adcode来查询指定地区的实时天气状况，包括天气现象、温度、湿度、风向和风力等。  ## 使用须知 - **参数优先级**：当你同时提供了 `city` (城市名) 和 `adcode` (城市编码) 两个参数时，系统会 **优先使用 `adcode`** 进行查询，因为它更精确。 - **查询范围**：为了保证查询的准确性，我们的服务仅支持标准的“省”、“市”、“区/县”级别的行政区划名称查询，不保证能查询到乡镇或具体地点。  ## 错误处理指南 - **410 Gone**: 这个特殊的错误码意味着你查询的地区无效或不受我们支持。比如你输入了“火星”，或者某个我们无法识别的村庄名称。这个状态码告诉你，这个“资源”是永久性地不可用了。
+出门前，查一下天气总是个好习惯。这个接口为你提供精准、实时的天气数据，支持国内和国际城市。  ## 功能概述 这个接口支持三种查询方式： - 可以传 `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)。
 
 ### Example
 
@@ -661,10 +929,22 @@ async function example() {
   const api = new MiscApi();
 
   const body = {
-    // string | 标准的城市名称，如 \'北京\', \'上海市\', \'福田区\'。请使用官方的省、市、区县行政区划名称。 (optional)
+    // string | 城市名称，支持中文（`北京`）和英文（`Tokyo`）。可选参数，不传时会尝试 IP 自动定位。 (optional)
     city: 北京,
-    // string | 高德地图的6位数字城市编码。例如，北京市的Adcode是 \'110000\'。使用Adcode查询更准确、更快速。 (optional)
-    adcode: 110000,
+    // string | 城市行政区划代码（如 `110000`），优先级高于 city。可选参数，不传时会尝试 IP 自动定位。 (optional)
+    adcode: adcode_example,
+    // boolean | 返回扩展气象字段（体感温度、能见度、气压、紫外线、降水量、云量、空气质量指数及污染物分项数据）。 (optional)
+    extended: true,
+    // boolean | 返回多天预报数据（最多7天），含每天的最高温度、最低温度、白天夜间天气、风向风力、日出日落等。 (optional)
+    forecast: true,
+    // boolean | 返回逐小时预报（24小时），含温度、天气、风向风速、湿度、降水概率等。 (optional)
+    hourly: true,
+    // boolean | 返回分钟级降水预报（仅国内城市），精确到2分钟。 (optional)
+    minutely: true,
+    // boolean | 返回18项生活指数（穿衣、紫外线、洗车、晾晒、空调、感冒、运动、舒适度、出行、钓鱼、过敏、防晒、心情、啤酒、雨伞、交通、空气净化器、花粉）。 (optional)
+    indices: true,
+    // 'zh' | 'en' | 返回语言。`zh` 返回中文（默认），`en` 返回英文。城市名翻译覆盖 7000+ 城市。生活指数（`indices`）目前仅支持中文。 (optional)
+    lang: lang_example,
   } satisfies GetMiscWeatherRequest;
 
   try {
@@ -684,8 +964,14 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **city** | `string` | 标准的城市名称，如 \'北京\', \'上海市\', \'福田区\'。请使用官方的省、市、区县行政区划名称。 | [Optional] [Defaults to `undefined`] |
-| **adcode** | `string` | 高德地图的6位数字城市编码。例如，北京市的Adcode是 \'110000\'。使用Adcode查询更准确、更快速。 | [Optional] [Defaults to `undefined`] |
+| **city** | `string` | 城市名称，支持中文（`北京`）和英文（`Tokyo`）。可选参数，不传时会尝试 IP 自动定位。 | [Optional] [Defaults to `undefined`] |
+| **adcode** | `string` | 城市行政区划代码（如 `110000`），优先级高于 city。可选参数，不传时会尝试 IP 自动定位。 | [Optional] [Defaults to `undefined`] |
+| **extended** | `boolean` | 返回扩展气象字段（体感温度、能见度、气压、紫外线、降水量、云量、空气质量指数及污染物分项数据）。 | [Optional] [Defaults to `undefined`] |
+| **forecast** | `boolean` | 返回多天预报数据（最多7天），含每天的最高温度、最低温度、白天夜间天气、风向风力、日出日落等。 | [Optional] [Defaults to `undefined`] |
+| **hourly** | `boolean` | 返回逐小时预报（24小时），含温度、天气、风向风速、湿度、降水概率等。 | [Optional] [Defaults to `undefined`] |
+| **minutely** | `boolean` | 返回分钟级降水预报（仅国内城市），精确到2分钟。 | [Optional] [Defaults to `undefined`] |
+| **indices** | `boolean` | 返回18项生活指数（穿衣、紫外线、洗车、晾晒、空调、感冒、运动、舒适度、出行、钓鱼、过敏、防晒、心情、啤酒、雨伞、交通、空气净化器、花粉）。 | [Optional] [Defaults to `undefined`] |
+| **lang** | `zh`, `en` | 返回语言。`zh` 返回中文（默认），`en` 返回英文。城市名翻译覆盖 7000+ 城市。生活指数（`indices`）目前仅支持中文。 | [Optional] [Defaults to `'zh'`] [Enum: zh, en] |
 
 ### Return type
 
@@ -705,10 +991,10 @@ No authorization required
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 | **200** | 查询成功！返回该地区的实时天气信息。 |  -  |
-| **400** | 请求参数错误。你必须提供 `city` 或 `adcode` 参数中的至少一个。 |  -  |
-| **410** | 查询的地区无效或不受支持。例如，你输入了 \'火星\' 或某个我们无法识别的村庄名称。这个状态码告诉你，这个“资源”是永久性地不可用了。 |  -  |
-| **500** | 服务器内部错误。在处理天气数据时发生了未知问题。 |  -  |
-| **502** | 上游服务错误。我们依赖的天气服务提供商（如高德地图）的API暂时不可用或返回了错误。 |  -  |
+| **400** | 参数无效。常见原因：`adcode` 格式非法、`lang` 非法（仅支持 zh/en）、参数值类型错误或参数组合无效。 |  -  |
+| **404** | 城市未找到。 |  -  |
+| **500** | 服务器内部错误。 |  -  |
+| **503** | 天气服务暂时不可用。 |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
@@ -717,7 +1003,7 @@ No authorization required
 
 > GetMiscWorldtime200Response getMiscWorldtime(city)
 
-查询全球任意时区的时间
+查询世界时间
 
 需要和国外的朋友开会，想知道他那边现在几点？用这个接口一查便知。  ## 功能概述 根据标准的时区名称（例如 \'Asia/Shanghai\' 或 \'Europe/London\'），获取该时区的当前准确时间、UTC偏移量、星期等信息。
 
@@ -781,3 +1067,71 @@ No authorization required
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
+
+## postMiscDateDiff
+
+> PostMiscDateDiff200Response postMiscDateDiff(postMiscDateDiffRequest)
+
+计算两个日期之间的时间差值
+
+想知道两个日期之间相差多久？这个接口帮你精确计算时间差值。  ## 功能概述 输入开始日期和结束日期，返回它们之间的时间差，包括总天数、总小时数、总分钟数、总秒数、总周数，以及人性化显示格式（如\"1年2月3天\"）。  ## 日期格式 接口支持自动识别常见日期格式，包括：YYYY-MM-DD、YYYY/MM/DD、DD-MM-YYYY、ISO 8601（带时区）等。也可以通过`format`参数显式指定格式（如DD-MM-YYYY）。  > [!NOTE] > 当结束日期早于开始日期时，返回的数值为负数。
+
+### Example
+
+```ts
+import {
+  Configuration,
+  MiscApi,
+} from 'uapi-browser-sdk-browser';
+import type { PostMiscDateDiffOperationRequest } from 'uapi-browser-sdk-browser';
+
+async function example() {
+  console.log("🚀 Testing uapi-browser-sdk-browser SDK...");
+  const api = new MiscApi();
+
+  const body = {
+    // PostMiscDateDiffRequest | 
+    postMiscDateDiffRequest: ...,
+  } satisfies PostMiscDateDiffOperationRequest;
+
+  try {
+    const data = await api.postMiscDateDiff(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **postMiscDateDiffRequest** | [PostMiscDateDiffRequest](PostMiscDateDiffRequest.md) |  | |
+
+### Return type
+
+[**PostMiscDateDiff200Response**](PostMiscDateDiff200Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | 计算成功，返回多种单位的时间差值 |  -  |
+| **400** | 日期解析失败或参数错误 |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+