This commit is contained in:
@@ -0,0 +1,230 @@
|
||||
\# AI全网最新资讯 - API 对接文档
|
||||
|
||||
|
||||
|
||||
\## 接口概览
|
||||
|
||||
该接口用于获取最近24小时内的全网AI最新资讯。内容涵盖模型发布/更新、开发工具/框架、学术研究/论文、公司/商业动态、应用案例/创意、技术问题讨论、伦理/安全等7个方面。数据缓存24小时,首次访问扣费,24小时内同一Key再次访问不重复扣费。
|
||||
|
||||
|
||||
|
||||
\## 请求地址
|
||||
|
||||
`https://api.pearapi.ai/api/latest\_ai\_consultative`
|
||||
|
||||
|
||||
|
||||
\## 请求方式
|
||||
|
||||
GET
|
||||
|
||||
|
||||
|
||||
\## 返回格式
|
||||
|
||||
JSON
|
||||
|
||||
|
||||
|
||||
\## 权限/付费要求
|
||||
|
||||
\- \*\*接口类型\*\*:免费接口
|
||||
|
||||
\- \*\*付费策略\*\*:首次请求扣费,24小时内同一Key重复请求不扣费。
|
||||
|
||||
|
||||
|
||||
\## 请求参数说明
|
||||
|
||||
|
||||
|
||||
| 参数名 | 是否必填 | 用途 |
|
||||
|
||||
| :--- | :--- | :--- |
|
||||
|
||||
| `key` | 是 | API Key值,用于身份验证。 |
|
||||
|
||||
|
||||
|
||||
\## 默认请求示例
|
||||
|
||||
```json
|
||||
|
||||
{
|
||||
|
||||
  "key": "xxx"
|
||||
|
||||
}
|
||||
|
||||
```
|
||||
|
||||
实际请求时,请将 `xxx` 替换为有效的API Key。
|
||||
|
||||
|
||||
|
||||
\## 返回字段说明
|
||||
|
||||
|
||||
|
||||
| 字段路径 | 类型 | 说明 |
|
||||
|
||||
| :--- | :--- | :--- |
|
||||
|
||||
| `code` | integer | 状态码。例如:200表示成功。 |
|
||||
|
||||
| `msg` | string | 状态信息。例如:“获取最新AI咨询成功”。 |
|
||||
|
||||
| `cache` | string | 是否命中缓存。 |
|
||||
|
||||
| `data` | object | 返回内容主体,包含所有分类的资讯数据。 |
|
||||
|
||||
| `data.image\_url` | string | AI报道的封面图片链接。 |
|
||||
|
||||
| `data.models\_and\_releases` | array | 模型发布/更新分类下的资讯列表。 |
|
||||
|
||||
| `data.models\_and\_releases\[].created\_at` | string | 资讯发布时间。 |
|
||||
|
||||
| `data.models\_and\_releases\[].title` | string | 资讯文章标题。 |
|
||||
|
||||
| `data.models\_and\_releases\[].summary` | string | 资讯文章详情摘要。 |
|
||||
|
||||
| `data.models\_and\_releases\[].source` | string | 资讯来源平台。 |
|
||||
|
||||
| `data.models\_and\_releases\[].url` | string | 资讯原文链接地址。 |
|
||||
|
||||
| `data.tools\_and\_frameworks` | array | 开发工具/框架分类下的资讯列表。元素结构与 `models\_and\_releases` 相同。 |
|
||||
|
||||
| `data.research\_and\_papers` | array | 学术研究/论文分类下的资讯列表。元素结构与 `models\_and\_releases` 相同。 |
|
||||
|
||||
| `data.industry\_and\_business` | array | 公司/商业动态分类下的资讯列表。元素结构与 `models\_and\_releases` 相同。 |
|
||||
|
||||
| `data.applications\_and\_use\_cases` | array | 应用案例/创意分类下的资讯列表。元素结构与 `models\_and\_releases` 相同。 |
|
||||
|
||||
| `data.technical\_discussions` | array | 技术问题讨论分类下的资讯列表。元素结构与 `models\_and\_releases` 相同。 |
|
||||
|
||||
| `data.ethics\_and\_safety` | array | 伦理/安全分类下的资讯列表。元素结构与 `models\_and\_releases` 相同。 |
|
||||
|
||||
| `data.models\_and\_architectures` | array | 未提供说明。 |
|
||||
|
||||
| `data.engineering\_and\_tools` | array | 未提供说明。 |
|
||||
|
||||
| `data.papers\_and\_research` | array | 未提供说明。 |
|
||||
|
||||
| `data.industry\_news` | array | 未提供说明。 |
|
||||
|
||||
| `api\_source` | string | 返回数据来源说明。 |
|
||||
|
||||
|
||||
|
||||
\## 返回示例
|
||||
|
||||
```json
|
||||
|
||||
{
|
||||
|
||||
  "code": 200,
|
||||
|
||||
  "msg": "获取最新AI咨询成功",
|
||||
|
||||
  "cache": true,
|
||||
|
||||
  "data": {
|
||||
|
||||
  "image\_url": "https://api.pearapi.ai/cache/images/2026-01-04/f658f4a2-8319-49b3-859d-4b5955c49e86.jpg",
|
||||
|
||||
  "models\_and\_releases": \[
|
||||
|
||||
  {
|
||||
|
||||
  "created\_at": "2026-01-04 15:06:49",
|
||||
|
||||
  "title": "Kimi 发布新模型 kiwi-do 并在 LM Arena 开启测试",
|
||||
|
||||
  "summary": "Kimi 旗下的新模型 kiwi-do 正式在 Chatbot Arena (lmarena) 平台上线并开启公开测试。该模型旨在通过竞技场实测收集用户反馈,以评估其在真实对话和复杂指令遵循方面的性能表现。这一动态显示了 Kimi 在模型迭代上的持续发力,通过公开竞技场测试有助于提升其在全球主流模型排名中的透明度与认可度。",
|
||||
|
||||
  "source": "linux.do",
|
||||
|
||||
  "url": "https://linux.do/t/topic/1403800"
|
||||
|
||||
  }
|
||||
|
||||
  ],
|
||||
|
||||
  "tools\_and\_frameworks": \[
|
||||
|
||||
  "省略"
|
||||
|
||||
  ],
|
||||
|
||||
  "research\_and\_papers": \[
|
||||
|
||||
  "省略"
|
||||
|
||||
  ],
|
||||
|
||||
  "industry\_and\_business": \[
|
||||
|
||||
  "省略"
|
||||
|
||||
  ],
|
||||
|
||||
  "applications\_and\_use\_cases": \[
|
||||
|
||||
  "省略"
|
||||
|
||||
  ],
|
||||
|
||||
  "technical\_discussions": \[
|
||||
|
||||
  "省略"
|
||||
|
||||
  ],
|
||||
|
||||
  "ethics\_and\_safety": \[
|
||||
|
||||
  "省略"
|
||||
|
||||
  ],
|
||||
|
||||
  "models\_and\_architectures": \[],
|
||||
|
||||
  "engineering\_and\_tools": \[],
|
||||
|
||||
  "papers\_and\_research": \[],
|
||||
|
||||
  "industry\_news": \[]
|
||||
|
||||
  },
|
||||
|
||||
  "api\_source": "官方API网:https://api.pearapi.ai/"
|
||||
|
||||
}
|
||||
|
||||
```
|
||||
|
||||
|
||||
|
||||
\## 对接注意事项
|
||||
|
||||
1\. \*\*Key验证\*\*:所有请求都必须携带有效的 `key` 参数,否则请求将被拒绝。
|
||||
|
||||
2\. \*\*缓存机制\*\*:接口数据缓存24小时。在缓存有效期内,使用相同的 `key` 再次请求将直接返回缓存数据,不会产生新的扣费。
|
||||
|
||||
3\. \*\*数据分类\*\*:返回的 `data` 对象中包含多个分类数组,每个数组内的元素结构均与示例中的 `models\_and\_releases` 数组元素一致(包含 `created\_at`, `title`, `summary`, `source`, `url` 字段)。
|
||||
|
||||
4\. \*\*空数组\*\*:示例中 `models\_and\_architectures`、`engineering\_and\_tools` 等字段可能返回空数组,表示该时段内无对应分类的资讯。
|
||||
|
||||
|
||||
|
||||
\## 给AI助手的实现建议
|
||||
|
||||
1\. \*\*请求构建\*\*:使用HTTP GET方法,将 `key` 作为查询参数附加到URL上。例如:`https://api.pearapi.ai/api/latest\_ai\_consultative?key=你的Key`。
|
||||
|
||||
2\. \*\*错误处理\*\*:建议检查返回的 `code` 字段。若 `code` 不为200,应根据 `msg` 字段内容进行错误提示。
|
||||
|
||||
3\. \*\*数据解析\*\*:解析JSON响应后,优先处理 `data` 对象下的 `models\_and\_releases`、`tools\_and\_frameworks` 等数组字段。遍历每个数组中的元素,提取 `title`、`summary`、`source`、`url` 和 `created\_at` 等信息进行展示。
|
||||
|
||||
4\. \*\*缓存判断\*\*:可以通过 `cache` 字段判断返回的数据是否为缓存数据,用于日志记录或调试。
|
||||
|
||||
5\. \*\*付费逻辑\*\*:无需在客户端实现复杂的付费逻辑,只需正常调用接口即可。服务端会自动处理首次扣费和缓存期内免扣费的策略。
|
||||
|
||||
@@ -0,0 +1,178 @@
|
||||
\### 接口概览
|
||||
|
||||
本接口用于获取各大平台今日热榜的排行数据。不传入任何参数时,将返回支持的平台列表(如 36氪、哔哩哔哩、知乎等)。传入指定平台标题后,可获取该平台的热点排行详情。
|
||||
|
||||
|
||||
|
||||
\### 请求地址
|
||||
|
||||
`https://api.pearapi.ai/api/dailyhot/`
|
||||
|
||||
|
||||
|
||||
\### 请求方式
|
||||
|
||||
GET
|
||||
|
||||
|
||||
|
||||
\### 返回格式
|
||||
|
||||
JSON
|
||||
|
||||
|
||||
|
||||
\### 权限/付费要求
|
||||
|
||||
免费接口,无需付费或特殊权限。
|
||||
|
||||
|
||||
|
||||
\### 请求参数说明
|
||||
|
||||
| 参数名 | 是否必填 | 用途 |
|
||||
|
||||
| :--- | :--- | :--- |
|
||||
|
||||
| `title` | 是 | 平台标题,用于指定要获取热榜的平台,例如“哔哩哔哩”。不传入此参数时,接口返回所有支持的平台列表。 |
|
||||
|
||||
|
||||
|
||||
\### 默认请求示例
|
||||
|
||||
```json
|
||||
|
||||
{
|
||||
|
||||
  "title": "哔哩哔哩"
|
||||
|
||||
}
|
||||
|
||||
```
|
||||
|
||||
对应的实际请求 URL 示例为:
|
||||
|
||||
`https://api.pearapi.ai/api/dailyhot/?title=哔哩哔哩`
|
||||
|
||||
|
||||
|
||||
\### 返回字段说明
|
||||
|
||||
| 字段路径 | 类型 | 描述 |
|
||||
|
||||
| :--- | :--- | :--- |
|
||||
|
||||
| `code` | integer | 状态码,表示请求结果 |
|
||||
|
||||
| `name` | string | 平台名称,如“哔哩哔哩” |
|
||||
|
||||
| `title` | string | 热点标题 |
|
||||
|
||||
| `type` | string | 榜单名称,如“热门视频” |
|
||||
|
||||
| `description` | string | 平台描述 |
|
||||
|
||||
| `link` | string | 来源目标链接 |
|
||||
|
||||
| `total` | integer | 获取到的热点数量 |
|
||||
|
||||
| `updateTime` | string | 数据更新时间 |
|
||||
|
||||
| `formCache` | string | 是否从缓存中获取(“是”或“否”) |
|
||||
|
||||
| `data` | string | 返回的热点数据列表,内部包含多个热点对象 |
|
||||
|
||||
| `data\[].id` | integer | 热点ID |
|
||||
|
||||
| `data\[].desc` | string | 热点描述 |
|
||||
|
||||
| `data\[].cover` | string | 热点封面图片链接 |
|
||||
|
||||
| `data\[].hot` | string | 热点热度数值 |
|
||||
|
||||
| `data\[].timestamp` | string | 热点时间戳 |
|
||||
|
||||
| `data\[].url` | string | 热点链接 |
|
||||
|
||||
| `data\[].mobileUrl` | string | 热点手机端链接 |
|
||||
|
||||
|
||||
|
||||
\### 返回示例
|
||||
|
||||
由于原配置中未提供示例结果,以下为根据字段结构构造的典型返回示例:
|
||||
|
||||
```json
|
||||
|
||||
{
|
||||
|
||||
  "code": 200,
|
||||
|
||||
  "name": "哔哩哔哩",
|
||||
|
||||
  "title": "哔哩哔哩热门视频",
|
||||
|
||||
  "type": "热门视频",
|
||||
|
||||
  "description": "哔哩哔哩弹幕视频网热门内容",
|
||||
|
||||
  "link": "https://www.bilibili.com/",
|
||||
|
||||
  "total": 50,
|
||||
|
||||
  "updateTime": "2025-04-10 12:00:00",
|
||||
|
||||
  "formCache": "否",
|
||||
|
||||
  "data": \[
|
||||
|
||||
  {
|
||||
|
||||
  "id": 1,
|
||||
|
||||
  "desc": "这是一个热门视频的简介",
|
||||
|
||||
  "cover": "https://example.com/cover.jpg",
|
||||
|
||||
  "hot": "123456",
|
||||
|
||||
  "timestamp": "2025-04-10 11:30:00",
|
||||
|
||||
  "url": "https://www.bilibili.com/video/example",
|
||||
|
||||
  "mobileUrl": "https://m.bilibili.com/video/example"
|
||||
|
||||
  }
|
||||
|
||||
  ]
|
||||
|
||||
}
|
||||
|
||||
```
|
||||
|
||||
|
||||
|
||||
\### 对接注意事项
|
||||
|
||||
1\. \*\*参数传递\*\*:`title` 参数必须通过 URL 查询字符串传递,如 `?title=哔哩哔哩`。
|
||||
|
||||
2\. \*\*平台名称\*\*:`title` 的值需与接口返回的平台列表中的名称完全一致,包括大小写和标点符号。
|
||||
|
||||
3\. \*\*返回结构\*\*:当不传入 `title` 时,返回的数据结构可能与传入 `title` 时不同,建议先测试无参数请求以获取平台列表。
|
||||
|
||||
4\. \*\*数据时效性\*\*:`updateTime` 和 `formCache` 字段可判断数据是否为最新,建议根据业务需求决定是否信任缓存数据。
|
||||
|
||||
|
||||
|
||||
\### 给 AI 助手的实现建议
|
||||
|
||||
1\. \*\*请求构建\*\*:使用 HTTP GET 方法,将 `title` 参数附加到 URL 后。如果用户未提供 `title`,则直接请求基础 URL。
|
||||
|
||||
2\. \*\*错误处理\*\*:检查返回的 `code` 字段,非 200 时视为请求失败,需提示用户或重试。
|
||||
|
||||
3\. \*\*数据解析\*\*:`data` 字段是一个数组,需遍历处理每个热点对象,提取 `id`、`desc`、`cover`、`hot`、`timestamp`、`url`、`mobileUrl` 等字段。
|
||||
|
||||
4\. \*\*平台列表获取\*\*:若用户未指定平台,可先调用无参数接口获取平台列表,再引导用户选择。
|
||||
|
||||
5\. \*\*编码问题\*\*:URL 中的中文字符(如“哔哩哔哩”)需进行 URL 编码,确保请求正确。
|
||||
|
||||
@@ -0,0 +1,102 @@
|
||||
\### 接口概览
|
||||
|
||||
该接口用于获取今天日期所发生的历史事件数据。
|
||||
|
||||
|
||||
|
||||
\### 请求地址
|
||||
|
||||
`https://api.pearapi.ai/api/lsjt/`
|
||||
|
||||
|
||||
|
||||
\### 请求方式
|
||||
|
||||
GET
|
||||
|
||||
|
||||
|
||||
\### 返回格式
|
||||
|
||||
JSON
|
||||
|
||||
|
||||
|
||||
\### 权限/付费要求
|
||||
|
||||
免费接口(无权限或付费要求)
|
||||
|
||||
|
||||
|
||||
\### 请求参数说明
|
||||
|
||||
|
||||
|
||||
| 参数名 | 是否必填 | 用途 |
|
||||
|
||||
| :--- | :--- | :--- |
|
||||
|
||||
| `type` | 否 | 指定返回数据的格式。可选值:`text`(返回纯文本),`json`(返回JSON数据)。 |
|
||||
|
||||
|
||||
|
||||
\### 默认请求示例
|
||||
|
||||
```json
|
||||
|
||||
{
|
||||
|
||||
  "type": "json"
|
||||
|
||||
}
|
||||
|
||||
```
|
||||
|
||||
对应的实际请求URL为:`https://api.pearapi.ai/api/lsjt/?type=json`
|
||||
|
||||
|
||||
|
||||
\### 返回字段说明
|
||||
|
||||
|
||||
|
||||
| 字段路径 | 类型 | 说明 |
|
||||
|
||||
| :--- | :--- | :--- |
|
||||
|
||||
| `code` | 字符串 | 状态码 |
|
||||
|
||||
| `msg` | 字符串 | 状态信息 |
|
||||
|
||||
| `time` | 字符串 | 时间(时间戳) |
|
||||
|
||||
| `data` | 字符串 | 返回内容(历史事件数据的具体内容) |
|
||||
|
||||
|
||||
|
||||
\### 返回示例
|
||||
|
||||
未提供。
|
||||
|
||||
|
||||
|
||||
\### 对接注意事项
|
||||
|
||||
1\. `type` 参数不是必填项,如果不传,将使用默认格式(具体默认格式请参考接口实际表现,文档未明确)。
|
||||
|
||||
2\. 返回的 `data` 字段为字符串类型,其内容格式取决于请求时 `type` 参数的值。如果请求 `type` 为 `json`,则 `data` 字段可能包含一个JSON格式的字符串,需要进一步解析。
|
||||
|
||||
3\. 接口返回的 `code` 字段用于判断请求是否成功,建议在代码中对其进行校验。
|
||||
|
||||
|
||||
|
||||
\### 给 AI 助手的实现建议
|
||||
|
||||
1\. \*\*请求构建\*\*:使用标准 HTTP GET 请求,将 `type` 参数作为查询字符串(Query String)附加在 URL 后。
|
||||
|
||||
2\. \*\*响应处理\*\*:首先将整个响应体解析为 JSON 对象。
|
||||
|
||||
3\. \*\*数据校验\*\*:检查解析后的 JSON 对象中的 `code` 字段,确认请求是否成功。
|
||||
|
||||
4\. \*\*数据提取\*\*:从 JSON 对象中提取 `data` 字段。注意,`data` 字段本身是一个字符串,如果请求的 `type` 为 `json`,你需要再次尝试将 `data` 字段的值解析为 JSON 对象,以便获取结构化的历史事件列表。
|
||||
|
||||
@@ -0,0 +1,182 @@
|
||||
\### 接口概览
|
||||
|
||||
本接口用于查询城际之间的出行路线信息,包括路线、距离、耗时、油费、过桥费、总费用及路况等详细数据。
|
||||
|
||||
|
||||
|
||||
\### 请求地址
|
||||
|
||||
`https://api.pearapi.ai/api/citytravelroutes/`
|
||||
|
||||
|
||||
|
||||
\### 请求方式
|
||||
|
||||
GET
|
||||
|
||||
|
||||
|
||||
\### 返回格式
|
||||
|
||||
JSON
|
||||
|
||||
|
||||
|
||||
\### 权限/付费要求
|
||||
|
||||
免费接口,无需付费或特殊权限。
|
||||
|
||||
|
||||
|
||||
\### 请求参数说明
|
||||
|
||||
|
||||
|
||||
| 参数名 | 是否必填 | 用途 |
|
||||
|
||||
| :--- | :--- | :--- |
|
||||
|
||||
| from | 是 | 出发地,例如“广州” |
|
||||
|
||||
| to | 是 | 目的地,例如“深圳” |
|
||||
|
||||
|
||||
|
||||
\### 默认请求示例
|
||||
|
||||
```json
|
||||
|
||||
{
|
||||
|
||||
  "from": "广州",
|
||||
|
||||
  "to": "深圳"
|
||||
|
||||
}
|
||||
|
||||
```
|
||||
|
||||
对应的实际请求 URL 示例为:`https://api.pearapi.ai/api/citytravelroutes/?from=广州\&to=深圳`
|
||||
|
||||
|
||||
|
||||
\### 返回字段说明
|
||||
|
||||
|
||||
|
||||
| 字段路径 | 类型 | 说明 |
|
||||
|
||||
| :--- | :--- | :--- |
|
||||
|
||||
| code | integer | 状态码 |
|
||||
|
||||
| msg | string | 状态信息 |
|
||||
|
||||
| from | string | 出发地 |
|
||||
|
||||
| to | string | 目的地 |
|
||||
|
||||
| data | string | 返回内容(可能包含路线列表或详细信息的字符串) |
|
||||
|
||||
| corese | string | 路线描述 |
|
||||
|
||||
| distance | string | 总距离 |
|
||||
|
||||
| time | string | 总耗时 |
|
||||
|
||||
| fuelcosts | string | 油费 |
|
||||
|
||||
| bridgetoll | string | 过桥费 |
|
||||
|
||||
| totalcost | string | 总费用 |
|
||||
|
||||
| roadconditions | string | 路况 |
|
||||
|
||||
|
||||
|
||||
\### 返回示例
|
||||
|
||||
原始接口配置中未提供返回示例(`example\_result` 字段为空),因此无法提供。请在实际对接时根据接口返回进行解析。
|
||||
|
||||
|
||||
|
||||
\### 对接注意事项
|
||||
|
||||
1\. \*\*参数传递方式\*\*:请求参数必填,通过 URL 查询字符串(Query String)的方式传递。
|
||||
|
||||
2\. \*\*编码问题\*\*:请求参数中的中文(如“广州”、“深圳”)需要进行 URL 编码(例如 UTF-8 编码)。
|
||||
|
||||
3\. \*\*返回数据结构\*\*:返回的 JSON 对象中,`data` 字段类型为字符串,可能包含结构化的文本信息,解析时需注意。
|
||||
|
||||
4\. \*\*字段类型\*\*:`distance`、`time`、`fuelcosts`、`bridgetoll`、`totalcost` 等字段虽然定义为字符串,但通常包含数字和单位(如“120公里”、“1.5小时”),提取数值时需进行字符串处理。
|
||||
|
||||
|
||||
|
||||
\### 给 AI 助手的实现建议
|
||||
|
||||
1\. \*\*请求构建\*\*:使用 HTTP GET 方法,将 `from` 和 `to` 参数作为 URL 的查询参数附加到基础 URL 后。
|
||||
|
||||
2\. \*\*参数编码\*\*:务必对 `from` 和 `to` 参数的值进行 URL 编码,以正确处理中文和特殊字符。
|
||||
|
||||
3\. \*\*响应处理\*\*:将返回的 JSON 字符串解析为对象(如 Python 的 `json` 模块,JavaScript 的 `JSON.parse`)。
|
||||
|
||||
4\. \*\*错误处理\*\*:检查返回的 `code` 字段值,判断请求是否成功。建议实现超时和重试机制。
|
||||
|
||||
5\. \*\*数据提取\*\*:对于 `distance`、`time` 等字段,如果需要纯数值,可以使用正则表达式提取数字部分。例如,从“120公里”中提取“120”。
|
||||
|
||||
6\. \*\*示例代码(Python)\*\*:
|
||||
|
||||
  ```python
|
||||
|
||||
  import requests
|
||||
|
||||
  import json
|
||||
|
||||
|
||||
|
||||
  def query\_city\_travel\_routes(from\_location, to\_location):
|
||||
|
||||
  url = "https://api.pearapi.ai/api/citytravelroutes/"
|
||||
|
||||
  params = {
|
||||
|
||||
  "from": from\_location,
|
||||
|
||||
  "to": to\_location
|
||||
|
||||
  }
|
||||
|
||||
  try:
|
||||
|
||||
  response = requests.get(url, params=params)
|
||||
|
||||
  response.raise\_for\_status() # 检查请求是否成功
|
||||
|
||||
  data = response.json()
|
||||
|
||||
  if data.get("code") == 200: # 假设成功状态码为200
|
||||
|
||||
  return data
|
||||
|
||||
  else:
|
||||
|
||||
  print(f"接口返回错误: {data.get('msg')}")
|
||||
|
||||
  return None
|
||||
|
||||
  except requests.exceptions.RequestException as e:
|
||||
|
||||
  print(f"请求失败: {e}")
|
||||
|
||||
  return None
|
||||
|
||||
|
||||
|
||||
  # 使用示例
|
||||
|
||||
  result = query\_city\_travel\_routes("广州", "深圳")
|
||||
|
||||
  if result:
|
||||
|
||||
  print(json.dumps(result, ensure\_ascii=False, indent=2))
|
||||
|
||||
@@ -0,0 +1,258 @@
|
||||
\---
|
||||
|
||||
title: "查询 QQ 信息"
|
||||
|
||||
locale: zh-CN
|
||||
|
||||
canonical: https://uapis.cn/docs/api-reference/get-social-qq-userinfo
|
||||
|
||||
source: https://uapis.cn/docs/api-reference/get-social-qq-userinfo.md
|
||||
|
||||
\---
|
||||
|
||||
|
||||
|
||||
\# 查询 QQ 信息
|
||||
|
||||
|
||||
|
||||
\*\*分类:\*\* 社交
|
||||
|
||||
|
||||
|
||||
通过 QQ 号查询用户资料,返回头像、昵称、个性签名、等级和 VIP 信息。
|
||||
|
||||
|
||||
|
||||
\## 功能概述
|
||||
|
||||
这个接口适合用在用户资料展示、头像卡片、账号绑定结果展示等场景。若用户把 QQ 等级设为隐藏,`qq\_level` 会返回 `null`。
|
||||
|
||||
|
||||
|
||||
\## 数据字段说明
|
||||
|
||||
\- \*\*基础信息\*\*: 昵称、个性签名、头像、年龄、性别
|
||||
|
||||
\- \*\*联系信息\*\*: QQ 邮箱、个性域名(QID)
|
||||
|
||||
\- \*\*等级信息\*\*: QQ 等级、VIP 状态和等级
|
||||
|
||||
\- \*\*时间信息\*\*: 注册时间、最后更新时间
|
||||
|
||||
|
||||
|
||||
\## API 端点
|
||||
|
||||
|
||||
|
||||
\*\*方法:\*\* GET
|
||||
|
||||
\*\*路径:\*\* /social/qq/userinfo
|
||||
|
||||
\*\*完整API地址:\*\* https://uapis.cn/api/v1/social/qq/userinfo
|
||||
|
||||
\*\*文档页面:\*\* https://uapis.cn/docs/api-reference/get-social-qq-userinfo
|
||||
|
||||
|
||||
|
||||
\## 响应
|
||||
|
||||
|
||||
|
||||
\### 200 / 请求成功
|
||||
|
||||
|
||||
|
||||
成功响应,返回QQ用户的详细信息
|
||||
|
||||
|
||||
|
||||
```json
|
||||
|
||||
{
|
||||
|
||||
  // QQ号
|
||||
|
||||
  "qq": "10001",
|
||||
|
||||
  // 用户昵称
|
||||
|
||||
  "nickname": "小明",
|
||||
|
||||
  // 个性签名
|
||||
|
||||
  "long\_nick": "今天天气真不错",
|
||||
|
||||
  // 头像URL
|
||||
|
||||
  "avatar\_url": "http://q.qlogo.cn/g?b=qq\&nk=10001\&s=640",
|
||||
|
||||
  // 年龄
|
||||
|
||||
  "age": 25,
|
||||
|
||||
  // 性别
|
||||
|
||||
  "sex": "男",
|
||||
|
||||
  // QQ个性域名
|
||||
|
||||
  "qid": "xiaoming2024",
|
||||
|
||||
  // QQ等级。用户隐藏时返回 null
|
||||
|
||||
  "qq\_level": 64,
|
||||
|
||||
  // 地理位置(省市)
|
||||
|
||||
  "location": "广东 深圳",
|
||||
|
||||
  // QQ邮箱
|
||||
|
||||
  "email": "10001@qq.com",
|
||||
|
||||
  // 是否为VIP用户
|
||||
|
||||
  "is\_vip": true,
|
||||
|
||||
  // 是否为年费VIP用户
|
||||
|
||||
  "is\_years\_vip": true,
|
||||
|
||||
  // 是否为SVIP用户
|
||||
|
||||
  "is\_svip": false,
|
||||
|
||||
  // 是否为QQ大会员用户
|
||||
|
||||
  "is\_big\_club": true,
|
||||
|
||||
  // 会员开通状态
|
||||
|
||||
  "vip\_status": 1,
|
||||
|
||||
  // 会员类型
|
||||
|
||||
  "vip\_type": 3,
|
||||
|
||||
  // VIP等级
|
||||
|
||||
  "vip\_level": 7,
|
||||
|
||||
  // QQ大会员等级
|
||||
|
||||
  "big\_club\_level": 1,
|
||||
|
||||
  // 黄钻等级(可选)
|
||||
|
||||
  "yellow\_diamond\_level": 10,
|
||||
|
||||
  // 绿钻等级(可选)
|
||||
|
||||
  "green\_diamond\_level": 9,
|
||||
|
||||
  // 腾讯影视会员等级(可选)
|
||||
|
||||
  "video\_vip\_level": 7,
|
||||
|
||||
  // 情侣/恋人类会员等级(可选)
|
||||
|
||||
  "lover\_vip\_level": 2,
|
||||
|
||||
  // 部分特权图标状态
|
||||
|
||||
  "privilege\_icons": {
|
||||
|
||||
  // VIP图标是否点亮
|
||||
|
||||
  "vip": true,
|
||||
|
||||
  // SVIP图标是否点亮
|
||||
|
||||
  "svip": false,
|
||||
|
||||
  // 年费VIP图标是否点亮
|
||||
|
||||
  "years\_vip": true,
|
||||
|
||||
  // QQ大会员图标是否点亮
|
||||
|
||||
  "big\_club": true
|
||||
|
||||
  },
|
||||
|
||||
  // 注册时间(ISO 8601格式)
|
||||
|
||||
  "reg\_time": "2008-03-15T10:30:00Z",
|
||||
|
||||
  // 最后更新时间(ISO 8601格式)
|
||||
|
||||
  "last\_updated": "2024-08-14T15:45:30Z"
|
||||
|
||||
}
|
||||
|
||||
```
|
||||
|
||||
|
||||
|
||||
\### 400 / 错误的请求
|
||||
|
||||
|
||||
|
||||
缺少或无效的qq参数
|
||||
|
||||
|
||||
|
||||
```json
|
||||
|
||||
{
|
||||
|
||||
  "code": "INVALID\_ARGUMENT",
|
||||
|
||||
  "details": {},
|
||||
|
||||
  "message": "Missing or invalid 'qq' parameter."
|
||||
|
||||
}
|
||||
|
||||
```
|
||||
|
||||
|
||||
|
||||
\### 404 / 未找到
|
||||
|
||||
|
||||
|
||||
获取QQ用户信息失败或用户不存在
|
||||
|
||||
|
||||
|
||||
```json
|
||||
|
||||
{
|
||||
|
||||
  "code": "NOT\_FOUND",
|
||||
|
||||
  "details": {},
|
||||
|
||||
  "message": "Failed to retrieve QQ user info, user may not exist."
|
||||
|
||||
}
|
||||
|
||||
```
|
||||
|
||||
|
||||
|
||||
\## 查询参数
|
||||
|
||||
|
||||
|
||||
\- \*\*`qq`\*\* (string) - 必填
|
||||
|
||||
  需要查询的QQ号
|
||||
|
||||
  示例:`10001`
|
||||
|
||||
  提示:纯数字的QQ号。
|
||||
|
||||
@@ -0,0 +1,180 @@
|
||||
好的,这是为您整理的猫眼电影实时票房排行接口对接文档,可直接用于指导AI编程助手进行开发。
|
||||
|
||||
|
||||
|
||||
\### 猫眼电影实时票房排行 - 接口对接文档
|
||||
|
||||
|
||||
|
||||
\#### 接口概览
|
||||
|
||||
本接口用于获取猫眼电影最新的实时票房排行数据,返回当天热门电影的票房、排片、上座率等关键指标。
|
||||
|
||||
|
||||
|
||||
\#### 请求地址
|
||||
|
||||
`https://api.pearapi.ai/api/maoyan/`
|
||||
|
||||
|
||||
|
||||
\#### 请求方式
|
||||
|
||||
GET
|
||||
|
||||
|
||||
|
||||
\#### 返回格式
|
||||
|
||||
JSON
|
||||
|
||||
|
||||
|
||||
\#### 权限/付费要求
|
||||
|
||||
免费接口,无需付费或特殊权限。
|
||||
|
||||
|
||||
|
||||
\#### 请求参数说明
|
||||
|
||||
无。该接口为GET请求,无需任何请求参数。
|
||||
|
||||
|
||||
|
||||
\#### 默认请求示例
|
||||
|
||||
```json
|
||||
|
||||
{}
|
||||
|
||||
```
|
||||
|
||||
|
||||
|
||||
\#### 返回字段说明
|
||||
|
||||
返回数据为JSON对象,包含顶层字段和嵌套在`data`字段中的数组。`data`字段是一个数组,每个元素代表一部电影的票房数据。
|
||||
|
||||
|
||||
|
||||
| 字段路径 | 类型 | 说明 |
|
||||
|
||||
| :--- | :--- | :--- |
|
||||
|
||||
| `code` | integer | 状态码,通常200表示成功。 |
|
||||
|
||||
| `msg` | string | 状态信息,例如“success”。 |
|
||||
|
||||
| `time` | string | 当前时间。 |
|
||||
|
||||
| `data` | array | 票房排行列表,包含多个电影对象。 |
|
||||
|
||||
| `data\[].top` | integer | 排行,例如1、2、3。 |
|
||||
|
||||
| `data\[].movieName` | string | 电影名。 |
|
||||
|
||||
| `data\[].releaseInfo` | string | 上映天数,例如“上映6天”。 |
|
||||
|
||||
| `data\[].sumBoxDesc` | string | 总票房,例如“2.53亿”。 |
|
||||
|
||||
| `data\[].boxRate` | string | 票房占比,例如“42.5%”。 |
|
||||
|
||||
| `data\[].showCount` | integer | 排场次数。 |
|
||||
|
||||
| `data\[].showCountRate` | string | 排片占比,例如“35.2%”。 |
|
||||
|
||||
| `data\[].avgShowView` | string | 场均人次。 |
|
||||
|
||||
| `data\[].avgSeatView` | string | 上座率,例如“12.3%”。 |
|
||||
|
||||
|
||||
|
||||
\#### 返回示例
|
||||
|
||||
由于原始配置中未提供示例结果,以下是根据字段说明构造的示例,实际返回数据可能略有差异。
|
||||
|
||||
```json
|
||||
|
||||
{
|
||||
|
||||
  "code": 200,
|
||||
|
||||
  "msg": "success",
|
||||
|
||||
  "time": "2024-05-20 14:30:00",
|
||||
|
||||
  "data": \[
|
||||
|
||||
  {
|
||||
|
||||
  "top": 1,
|
||||
|
||||
  "movieName": "示例电影A",
|
||||
|
||||
  "releaseInfo": "上映6天",
|
||||
|
||||
  "sumBoxDesc": "2.53亿",
|
||||
|
||||
  "boxRate": "42.5%",
|
||||
|
||||
  "showCount": 123456,
|
||||
|
||||
  "showCountRate": "35.2%",
|
||||
|
||||
  "avgShowView": "45",
|
||||
|
||||
  "avgSeatView": "12.3%"
|
||||
|
||||
  },
|
||||
|
||||
  {
|
||||
|
||||
  "top": 2,
|
||||
|
||||
  "movieName": "示例电影B",
|
||||
|
||||
  "releaseInfo": "上映13天",
|
||||
|
||||
  "sumBoxDesc": "1.87亿",
|
||||
|
||||
  "boxRate": "28.1%",
|
||||
|
||||
  "showCount": 98765,
|
||||
|
||||
  "showCountRate": "28.5%",
|
||||
|
||||
  "avgShowView": "38",
|
||||
|
||||
  "avgSeatView": "10.1%"
|
||||
|
||||
  }
|
||||
|
||||
  ]
|
||||
|
||||
}
|
||||
|
||||
```
|
||||
|
||||
|
||||
|
||||
\#### 对接注意事项
|
||||
|
||||
1\. \*\*无参数请求\*\*:直接对请求地址发起GET请求即可,无需拼接任何查询参数。
|
||||
|
||||
2\. \*\*数据解析\*\*:请注意`data`字段是一个数组,需要遍历获取每部电影的排行数据。
|
||||
|
||||
3\. \*\*字段类型\*\*:`showCount`为整数类型,其余数字相关字段(如`boxRate`、`showCountRate`)为字符串类型,其中可能包含“%”等符号,在需要进行数学计算时需先进行字符串处理。
|
||||
|
||||
|
||||
|
||||
\#### 给AI助手的实现建议
|
||||
|
||||
1\. \*\*发起请求\*\*:使用HTTP客户端库(如Python的`requests`、JavaScript的`axios`或`fetch`)对 `https://api.pearapi.ai/api/maoyan/` 发起一个不带任何body和params的GET请求。
|
||||
|
||||
2\. \*\*错误处理\*\*:检查返回的`code`字段是否为200。如果不是,可以根据`msg`字段进行错误提示。
|
||||
|
||||
3\. \*\*数据提取\*\*:成功获取数据后,从返回的JSON对象中提取`data`数组,然后遍历该数组,按需求提取`top`、`movieName`、`sumBoxDesc`等字段。
|
||||
|
||||
4\. \*\*数据展示\*\*:由于`boxRate`、`showCountRate`等字段是包含百分号的字符串,如果需要在图表中展示或进行排序,建议先转换为浮点数。
|
||||
|
||||
Reference in New Issue
Block a user