QWQLwToo
103 lines
2.0 KiB
Markdown
103 lines
2.0 KiB
Markdown
\### 接口概览
|
|
|
|
该接口用于获取今天日期所发生的历史事件数据。
|
|
|
|
|
|
|
|
\### 请求地址
|
|
|
|
`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 对象，以便获取结构化的历史事件列表。
|
|
|