# API 调用日志查询

微信开发者平台「工具箱」为开发者提供统一的接口诊断和调试服务，帮助开发者快速定位和解决 API 调用过程中遇到的问题。

「工具箱」目前包含「调用日志查询」和「API 报错诊断」两项能力。其中「调用日志查询」可帮助开发者查看指定应用账号在一定时间范围内的 API 调用错误日志和来源 IP 明细，便于快速发现接口调用异常、定位错误原因。

操作路径

• 微信开发者平台 - 控制台 - 工具箱 - 调用日志查询
• 快速体验：https://developers.weixin.qq.com/console/devtools/debug?tab=callLog

# 1、使用步骤

# 1.1 选择应用账号

进入「调用日志查询」页面后，需先选择你要查询的应用账号。下拉选择框会列出当前登录用户拥有的所有业务账号，支持的业务类型包括：小程序、小游戏、公众号、服务号、移动应用、网站应用、第三方平台、微信小店、带货助手、视频号助手等。

系统默认自动选中第一个账号并发起查询。

# 1.2 选择时间范围

在时间范围下拉框中选择要查询的时间跨度，当前支持：

切换应用账号或时间范围后，系统会自动重新发起查询。

# 1.3 查看调用日志

查询结果通过两个子标签页展示：「调用错误日志」和「IP 明细」。每个标签页标题后会显示当前数据总条数，方便快速了解概况。

# 2、调用错误日志

「调用错误日志」展示指定账号在选定时间范围内所有出现过错误的 API 接口汇总信息，每页显示 20 条记录，支持分页浏览。

展示字段

# 2.1 筛选功能

在「调用错误日志」标签页中，点击「筛选」可打开筛选弹窗，支持按以下条件对当前结果进行筛选：

1）API 名称：输入接口名称关键词进行模糊匹配（最多 30 个字符）

2）错误码：输入数字错误码进行匹配

点击「确定」应用筛选条件，点击「重置」清除所有筛选条件，点击「取消」关闭弹窗。

注意：筛选功能是对当前页面已加载的数据进行过滤，如需查看全部数据请先翻页后再筛选。

# 2.2 下载功能

点击「下载」按钮可将当前页面显示的调用错误日志导出为 CSV 文件，方便离线分析。导出文件包含：API 名称、错误码、错误描述、总调用次数、错误次数、错误占比等全部字段。

注意：当查询结果为空时，下载按钮不可用。

# 3、IP 明细

「IP 明细」展示指定账号在选定时间范围内所有调用来源 IP 的汇总信息，帮助开发者了解 API 调用的来源分布情况，及时发现异常调用来源。

展示字段

# 3.1 「新 IP」判定规则

「是否新 IP」用于帮助开发者快速识别新增的调用来源，其判定规则为：如果某个 IP 地址最近7天没有出现过，则标记为「新 IP」。

使用场景

• 安全监控：如果出现大量未知的新 IP 调用，可能存在 AppSecret 泄露或接口被盗用的风险，建议及时检查并重置密钥
• 环境变更确认：在服务器迁移或扩容后，可通过新 IP 标记确认新服务器是否已正常接入调用
• 异常排查：结合调用错误日志，判断错误是否集中来源于某个新出现的 IP，辅助定位问题

# 3.2 下载功能

「IP 明细」同样支持下载功能，点击「下载」按钮可将当前页面数据导出为 CSV 文件，包含来源 IP、调用次数、是否新 IP 等字段。

# 4、注意事项

1）使用「调用日志查询」需先登录微信开发者平台，且当前登录用户需为目标账号的管理员或开发者

2）仅展示用户有权限访问的应用账号数据

3）每页固定显示 20 条记录，可通过翻页查看更多数据

4）如需针对某一次具体的 API 报错进行深入诊断（查看请求包、响应包等详细信息），可使用「API 报错诊断」功能，通过 rid 进行精确定位