2.0 KiB
### 接口概览
该接口用于获取今天日期所发生的历史事件数据。
### 请求地址
https://api.pearapi.ai/api/lsjt/
### 请求方式
GET
### 返回格式
JSON
### 权限/付费要求
免费接口(无权限或付费要求)
### 请求参数说明
| 参数名 | 是否必填 | 用途 |
| :--- | :--- | :--- |
| type | 否 | 指定返回数据的格式。可选值:text(返回纯文本),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 对象,以便获取结构化的历史事件列表。