2.9.5、开放接口日志

一、功能概述

本系统提供操作日志与开放接口日志的查询功能，方便用户对系统内的操作记录及接口调用情况进行查看与管理，有助于排查问题。

用于记录通过开放接口相关，所产生的数据，便于排查开放接口对接类相关问题

二、界面说明

（一）入口

系统管理 ——>开放接口日志

（二）查询条件区域

1. 数据类型：下拉选择框，用户可通过此选项筛选特定类型的数据日志。例如，可选择与车辆相关数据、用户操作数据等不同类型。
2. 操作标识：输入框，用于输入特定的操作标识进行精准查询。操作标识是对每次操作的唯一编码或特定标识符。
3. 请求内容关键字：输入框，可输入请求内容中的关键字，如某个参数值、特定文本等，以便查找包含该关键字的日志记录。
4. 时间范围：包含两个日期时间选择器，分别用于选择查询的起始时间和结束时间。例如，图中选择了“2024 - 03 - 04 14:52:35”作为起始和结束时间，表示查询该时刻的日志记录。
5. 搜索：绿色按钮，点击此按钮将根据上述设置的查询条件进行日志记录的检索。

（三）日志列表区域

查询结果以列表形式展示在下方，每行代表一条日志记录，包含以下列：

1. 操作标识：显示每次操作的唯一标识符，如“1764544450321743873”，可用于详细追踪特定操作。
2. 数据类型：以标签形式展示数据的类型，如图中的“上行数据”，不同颜色或样式可区分不同类型的数据。
3. 路由类型：显示接口调用的路由类型，如“VehicleEntryCallBack”，表示该操作对应的接口路由。
4. 请求内容：展示请求的具体内容，通常以 JSON 等格式呈现，如“{"ParkKey":"17095489843374…””，包含了请求时传递的参数等信息。
5. 响应内容：显示接口调用的响应内容，若响应为空则显示为空字符串，如图中的“”””。
6. 操作时间：记录操作发生的具体时间，精确到秒，如“2024 - 03 - 04 14:52:35”。
7. 操作状态：显示操作当前的状态，如“正在处理中(值0)”，不同的状态值代表不同的处理进度或结果情况。

三、操作指南

（一）基本查询

1. 若仅需按时间查询日志，可在时间选择器中设置起始和结束时间，然后点击“搜索”按钮，系统将返回该时间段内的所有日志记录。
2. 若要筛选特定数据类型的日志，先在下拉选择框中选择相应的数据类型，再点击“搜索”按钮。
3. 若知道具体的操作标识或请求内容关键字，可在对应的输入框中输入内容后点击“搜索”按钮进行精准查询。

四、注意事项

1. 时间选择器的格式需按照系统规定的“年 - 月 - 日 时:分:秒”格式进行选择，否则可能导致查询结果不准确。

2. 输入查询条件时，请确保输入内容的准确性，特别是操作标识和请求内容关键字，以免无法查询到所需日志记录。

3. 若查询结果较多，系统可能会进行分页显示，可通过页面底部的分页控件进行翻页操作。

4. 接口类型支持：仅支持V2接口和MQTT接口，不支持V1接口