调用日志接口¶
调用日志接口用于查看 API 调用记录，方便排查问题和监控使用情况。
认证方式
所有日志接口需要使用 JWT Token 认证。
接口列表¶
| 接口 | 方法 | 说明 |
|---|---|---|
| /api/api-call-logs/ | GET | 获取调用日志 |
获取调用日志¶
获取当前用户的 API 调用记录。
请求¶
地址：GET https://api.upath.cn/api/api-call-logs/
请求头：
| 参数 | 必填 | 说明 |
|---|---|---|
| Authorization | 是 | Bearer |
查询参数：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page | integer | 否 | 页码，默认 1 |
| page_size | integer | 否 | 每页数量，默认 20 |
| action | string | 否 | 接口名称筛选 |
| status_code | integer | 否 | 状态码筛选 |
| start_time | string | 否 | 开始时间（ISO 8601 格式） |
| end_time | string | 否 | 结束时间（ISO 8601 格式） |
响应¶
成功响应：
| 字段 | 类型 | 说明 |
|---|---|---|
| count | integer | 总记录数 |
| next | string | 下一页 URL |
| previous | string | 上一页 URL |
| results | array | 日志列表 |
| results[].id | integer | 日志 ID |
| results[].action | string | 接口名称 |
| results[].request_id | string | 请求 ID |
| results[].status_code | integer | HTTP 状态码 |
| results[].response_time_ms | integer | 响应时间（毫秒） |
| results[].created_at | string | 调用时间 |
Action 类型¶
| Action | 说明 |
|---|---|
| getScenes | 获取场景配置 |
| StartVoiceChat | 启动语音对话 |
| StopVoiceChat | 停止语音对话 |
使用场景¶
问题排查¶
当遇到接口调用失败时，可以通过日志查询定位问题：
- 使用
request_id定位具体请求 - 查看
status_code判断错误类型 - 根据时间范围筛选相关记录
用量监控¶
通过日志统计可以了解：
- API 调用频次
- 接口响应时间
- 错误率分布
日志保留
API 调用日志保留 30 天，超过 30 天的日志会自动清理。
数据隔离¶
安全说明
- 只能查看自己的 API 调用日志
- 无法查看其他用户的调用记录
- 敏感信息（如 API Key）已脱敏处理