调用记录
功能概览
功能定位
调用记录 用于集中查看 API 服务产生的调用日志，帮助用户按服务类目和查询条件定位单次调用，核对调用来源、接口地址、数据量、耗时、状态和异常信息，并按需删除目标记录。
简单理解：每次 API 被调用后，都可以在这里查到“谁调用了哪个接口、传了什么、用了多久、结果怎样”。
使用建议
排查单次 API 调用时，建议先按 服务类目或服务名称缩小范围 → 查看列表中的接口地址与耗时 → 打开【详情】核对参数、状态和异常信息 的顺序操作。
主要特性
- 组合查询：按 API 服务类目、API 服务名称、状态和调用时间定位调用记录。
- 调用概览：查看 API 服务名称、类目、调用者 IP、接口地址、调用数据量和调用耗时。
- 详情核对：通过【详情】查看单次调用的参数、时间、方式、状态和异常信息。
- 单条删除：删除目标调用记录；该操作不影响其他业务。
- 分页信息：查看记录总数、每页条数、当前页和分页控件。
作用范围
【调用记录】用于查看和定位 API 服务产生的调用记录。API 管理和服务分类提供服务名称、接口地址和类目等上游信息；本页提供记录查询、详情查看和单条删除入口。本页不说明下载、导出、实际翻页结果、删除确认文案或其他角色权限规则。
前置步骤
前置条件
- 已登录 qData 平台。
- 当前账号能够访问【数据服务】模块。
- 当前账号能够看到【调用记录】菜单。
- 系统中已产生可供浏览的 API 调用记录。
导航路径
数据服务 > 调用记录
页面总览
进入【调用记录】后，左侧显示 API 服务类目搜索和类目入口；上方显示 API 服务名称、状态、调用时间、【查询】和【重置】；中部显示调用记录列表及【详情】【删除】入口；底部显示分页信息和分页控件。
调用记录列表字段
| 字段名 | 说明 | 是否必填 |
|---|---|---|
| 编号 | 当前调用记录编号。 | 不适用（系统展示） |
| API服务名称 | 本次调用关联的 API 服务名称。 | 不适用（系统展示） |
| API服务类目 | 本次调用关联 API 所属的服务类目。 | 不适用（系统展示） |
| 调用者IP | 发起调用的客户端网络地址。 | 不适用（系统展示） |
| 调用接口地址 | 本次调用实际使用的接口路径。 | 不适用（系统展示） |
| 调用数据量 | 系统记录的本次调用数据量。 | 不适用（系统展示） |
| 调用耗时(秒) | 本次调用耗费的时间，以秒为单位。 | 不适用（系统展示） |
| 操作 | 显示【详情】和【删除】入口。 | 不适用（系统展示） |
列表底部显示记录总数、每页条数、页码、前后翻页和跳页控件；本页只说明控件呈现，不说明实际翻页、跳页或每页条数切换结果。
推荐操作流程
查看调用情况：进入【调用记录】 → 选择服务类目或填写查询条件 → 点击【查询】 → 核对接口地址、数据量和耗时。
排查单次调用：在列表中定位目标记录 → 点击【详情】 → 查看调用参数、请求方式、状态和异常信息记录 → 关闭详情弹窗。
清理目标记录：确认目标记录后点击【删除】 → 按原条件再次查询 → 确认目标记录不再返回，同时核对其他记录仍正常存在。
功能操作说明
进入调用记录页面
- 进入【数据服务】模块。
- 点击左侧【调用记录】菜单。
- 查看顶部激活的【调用记录】页签。
- 查看调用记录页面主体。
查询调用记录
- 在左侧类目搜索框中输入 API 服务类目关键字。
- 在左侧选择 API 服务类目。
- 在“API服务名称”输入框中填写服务名称。
- 在“状态”下拉框中选择状态。
- 在“调用时间”区域选择开始日期。
- 在“调用时间”区域选择结束日期。
- 点击【查询】。
- 在调用记录列表中查看结果。
- 需要清空条件时，点击【重置】。
查询匹配规则、状态枚举、日期校验和点击【重置】后的刷新时机以页面实际行为为准。
查看调用记录列表
- 查看调用记录列表。
- 定位目标服务名称。
- 查看目标记录的调用接口地址。
- 查看目标记录的调用数据量。
- 查看目标记录的调用耗时(秒)。
- 查看目标记录右侧的【详情】入口。
- 查看目标记录右侧的【删除】入口。
- 查看列表底部的分页信息和分页控件。
“状态”和“调用时间”是查询条件，不是当前列表展示列。
查看 API 服务调用日志详情
- 在列表中定位目标调用记录。
- 点击目标记录操作列中的【详情】。
- 查看标题为“API服务调用日志详情”的弹窗。
- 查看弹窗中的 API 服务名称。
- 查看弹窗中的调用者 IP。
- 查看弹窗中的调用接口地址。
- 查看弹窗中的调用参数。
- 查看弹窗中的调用时间。
- 查看弹窗中的调用耗时(秒)。
- 查看弹窗中的请求方式。
- 查看弹窗中的调用数据量。
- 查看弹窗中的异常信息记录。
- 查看弹窗中的状态。
- 需要关闭弹窗时，点击右上角关闭图标。
- 也可以点击弹窗底部的【关闭】。
| 字段名 | 说明 | 是否必填 |
|---|---|---|
| API服务名称 | 本次调用关联的 API 服务名称。 | 不适用（系统展示） |
| 调用者IP | 发起调用的客户端网络地址。 | 不适用（系统展示） |
| 调用接口地址 | 本次调用实际使用的接口路径。 | 不适用（系统展示） |
| 调用参数 | 展示本次调用携带的参数内容。 | 不适用（系统展示） |
| 调用时间 | 本次调用发生的时间。 | 不适用（系统展示） |
| 调用耗时(秒) | 本次调用耗费的时间，以秒为单位。 | 不适用（系统展示） |
| 请求方式 | 本次调用使用的请求方式。 | 不适用（系统展示） |
| 调用数据量 | 系统记录的本次调用数据量。 | 不适用（系统展示） |
| 异常信息记录 | 展示本次调用的异常信息记录。 | 不适用（系统展示） |
| 状态 | 展示本次调用的处理状态。 | 不适用（系统展示） |
删除目标调用记录
- 在列表中定位需要删除的目标调用记录。
- 点击目标记录操作列中的【删除】。
- 再次按原条件查询调用记录。
- 确认已删除的目标记录不再返回。
- 确认其他调用记录、其他业务数据和业务流程不受影响。
常见问题
- 删除一条调用记录会影响其他业务吗？
不会。删除操作只删除目标调用记录，不影响其他调用记录、其他业务数据和业务流程。确认文案、具体成功提示和即时刷新方式以页面实际行为为准。
总结
【调用记录】用于查询 API 调用记录、查看单次调用详情和删除目标记录。排查时重点核对 服务名称、调用者 IP、接口地址、调用参数、耗时、状态和异常信息；查询匹配、分页操作和删除交互细节不在本页说明范围内。