开放接口日志

#### 功能概述

* “开放接口日志”模块，用于记录通过开放接口相关，所产生的数据，便于排查开放接口对接类相关问题。
* 支持V2和MQTT接口，不支持V1接口

#### 操作入口

* 进入停车场管理软件后台，导航至【系统管理 / 开放接口日志】页面。

![](/media/202607/20260706094709531626.png)

#### 功能描述

* **查询功能**：支持按数据类型、操作标识、请求内容关键字、时间范围等条件组合搜索，快速定位所需的开放接口日志记录。
* **日志查看**：以表格形式展示开放接口日志的详细信息，包括操作标识、数据类型、路由类型、请求内容、响应内容、操作时间、操作状态等。

#### 操作步骤

##### 基本查询

1. **按时间查询日志**：
	* 在时间选择器中设置起始和结束时间。
	* 点击搜索按钮，系统将返回该时间段内的所有开放接口日志记录。
2. **筛选特定数据类型的日志**：
	* 在下拉选择框中选择相应的数据类型。
	* 点击搜索按钮。
3. **精准查询**：
	* 在操作标识或请求内容关键字输入框中输入具体内容。
	* 点击搜索按钮进行查询。

##### 查看日志详情

1. 在日志列表中，找到需要查看的记录。
2. 直接在列表中查看每条记录的详细信息，包括操作标识、数据类型、路由类型、请求内容、响应内容、操作时间、操作状态等。

#### 注意事项

1. 输入查询条件时，请确保输入内容的准确性，特别是操作标识和请求内容关键字，以免无法查询到所需日志记录。
2. 若查询结果较多，系统可能会进行分页显示，可通过页面底部的分页控件进行翻页操作。
3. 接口类型支持：仅支持V2接口和MQTT接口，不支持V1接口。

#### 常见问题解答（FAQ）

##### 问题1：如何进行开放接口日志的搜索

操作步骤：

1. 在查询条件区域，设置起始和结束时间、选择数据类型、输入操作标识或请求内容关键字。
2. 点击搜索按钮，系统将根据设置的条件返回相应的开放接口日志记录。

##### 问题2：如何查看开放接口日志的详细信息

操作步骤：

1. 在日志列表中，找到需要查看的记录。
2. 直接在列表中查看每条记录的详细信息，包括操作标识、数据类型、路由类型、请求内容、响应内容、操作时间、操作状态等。

##### 问题3：开放接口日志模块的作用是什么

* 开放接口日志模块用于记录和展示系统中通过开放接口产生的各类操作的详细信息，帮助管理员监控接口调用情况、追踪操作记录以及进行问题排查。特别适用于排查开放接口对接类相关问题。

##### 问题4：开放接口日志模块支持哪些搜索条件

* 开放接口日志模块支持按数据类型、操作标识、请求内容关键字、时间范围等条件组合搜索，快速定位所需的开放接口日志记录。

##### 问题5：为什么查询不到特定接口的日志？

* 可能原因：
	+ 选择了错误的接口类型（如查询V1接口日志）
	+ 时间范围未包含实际调用时间
	+ 操作标识输入错误或不存在
* 解决方案：
	1. 确认接口属于V2/MQTT类型
	2. 检查系统日志时间同步状态
	3. 通过日志先定位大致时间范围

##### 问题6：日志响应内容提示【由于目标计算机积极拒绝，无法连接】如何排查？

* 检查接口填写的地址是否正确并且能够正常访问。
* 检查是否有防火墙拦截或者网络限制。
* 检查端口配置是否正确。