日志
概述
日志是您可以在一处查看某个端点所有 API 调用记录的页面。您可以查看请求的成功/失败、发送的 Payload、Webhook 投递状态以及错误信息。
沙盒环境和生产环境分别位于不同的标签页中，因此您可以独立追踪测试调用和正式运营调用。
如何进入
- 顶部菜单 日志 → 从列表中选择一个端点
- 端点详情右侧边栏中的 查看日志 链接
端点列表
首次打开日志页面时，您会看到端点列表。它按端点汇总了日志状态。
| 列 | 说明 |
|---|---|
| 端点 | 端点名称 |
| 总日志数 | 此端点的总调用次数 |
| 成功率 | 成功调用所占的百分比 |
| 最近活动 | 最近一次调用时间（相对时间） |
点击某个端点即可进入其详细日志页面。
详细页面顶部
选择某个端点后，页面顶部会显示以下元素。
- 端点名称和说明
查看 API 详情按钮 — 前往端点详情页面清除沙盒数据按钮 — 永久删除此端点的沙盒调用记录和使用统计- 协作者访问时显示为
清除我的沙盒数据，仅删除该协作者生成的记录 - 不会影响生产环境数据
- 协作者访问时显示为
- 沙盒环境 | 生产环境 环境标签页 — 独立查看各环境的日志（详细了解环境标签页）
搜索筛选
搜索区域包含两个标签页：时间段搜索 和 字段搜索。
时间段搜索
按时间范围和状态筛选日志。
- 日期字段 — 选择
处理时间或创建时间。默认为处理时间 - 开始日期 / 结束日期 — 指定时间范围
- 状态 — 可选择
全部/成功/失败/Webhook 失败Webhook 失败仅显示已成功存储、但 Webhook 最终未送达接收服务器或仍在重试的调用。选择该项后，请求 ID 与内容搜索条件会被清除
- 协作密钥 —
全部或特定的协作密钥（仅显示使用该密钥发起的调用）
字段搜索
当您希望按特定值查找日志时使用。
- 字段 选择：
请求 ID— 按记录 ID 精确匹配（支持前缀匹配）内容搜索— 在整个 payload 中进行子串匹配（不区分大小写），至少 3 个字符
- 输入 搜索值 并执行
- 选择
内容搜索时会出现 开始日期 / 结束日期 输入框。若未指定日期，默认在最近 30 天内搜索
内容搜索的工作方式与局限
- 搜索范围：将记录的 payload（整个 JSON 文档）序列化为文本后进行子串匹配
- 多语言支持：中文、英文、韩文、日文等均可正常匹配（英文不区分大小写）
- 数字也可搜索，但同样按子串匹配：例如
"32"既能匹配age:32，也会匹配132、321等包含32的文本 - JSON 键名也会被索引：用
"name"或"address"这类通用键名搜索会匹配所有记录 — 建议使用更具体的关键词 - 不支持：比较运算符（
>、<、=）、值的精确匹配、按字段范围限定的检索
日志列表
搜索筛选下方以表格形式显示该端点的调用历史。
| 列 | 说明 |
|---|---|
| 请求 ID | 记录标识符 |
| 状态 | 成功 · 失败 · 处理中 徽章 |
| Webhook | 仅在投递失败或正在重试时显示徽章（见下文） |
| 协作密钥 | 本次调用使用的协作密钥（未指定则为默认） |
| 创建时间 | API 调用接收时间 |
| 处理时间 | 存储和 Webhook 处理完成时间 |
如何读懂 Webhook 列 — 该列仅在已配置 Webhook 的端点上出现。
| 徽章 | 含义 |
|---|---|
⚠ 502 |
失败 — 重试已全部用尽，最终仍未送达。数字是接收服务器返回的状态码；若完全没有响应，则显示 超时 |
↻ 502 (3/6) |
重试中 — 括号表示 当前尝试次数 / 总尝试次数（生产 6 次，沙盒 4 次；首次投递算第 1 次）。下次重试时间可在日志详情中查看 |
✓ 已恢复 |
起初失败，但在后续重试中成功送达 |
空白并不代表成功。 系统只记录失败的投递，因此成功送达的 Webhook 不会留下任何痕迹。在未配置 Webhook 的端点上，该列会被完全隐藏。
如果同一次调用同时配置了所有者 Webhook 和协作者 Webhook，列表中只显示更严重的那一条。要分别查看，请进入日志详情页面。
点击任意行即可进入日志详情页面。
日志详情页面
概览
显示单次调用的详细信息。
- 请求 ID：记录的唯一标识符
- 端点：接收此次调用的端点
- 版本：调用时的配置版本
- 处理时间：存储和 Webhook 处理完成时间
- 响应时间：网关处理时间（毫秒）
- 协作密钥：所使用协作密钥的名称和描述（如适用）
- 错误信息 / 错误详情：对于失败的调用，显示错误类型、状态码、字段错误和发生时间
查看端点按钮 — 前往此端点的详情页面
Webhook 投递
仅当本次调用的 Webhook 投递失败或仍在重试时才会出现的卡片。所有者 Webhook 在上，协作者 Webhook 在下。
- 状态徽章与尝试次数 — 与列表相同的徽章，另外显示
尝试 N 次、状态码、最后一次错误以及接收主机 - 响应 — 接收服务器返回的响应正文原文（截取开头部分）。它几乎是区分防火墙（WAF）拦截与应用主动拒绝的唯一线索。提供复制按钮
- 尝试记录 — 每次尝试的时间、状态码（或
超时）以及耗时（毫秒）。由自动重试触发的尝试会标记自动重试 - 下次重试 — 若仍有剩余尝试，显示下次预定时间
只记录失败的投递。 成功送达的 Webhook 不会在此留下记录，因此没有这张卡片意味着"没有失败记录"，而不是"已确认送达"。
不提供手动重发。 所有重试均为自动进行，用尽后无法再次发送。修复接收服务器后，下一次 API 调用即可正常送达。
您无需一直盯着这个页面。 当生产环境的所有者 Webhook 投递被放弃时，我们会发邮件通知您（不分套餐，免费套餐同样适用）——每个端点每天最多一封。而查看每次尝试记录和响应正文，仍然要来这个页面。
重试间隔以及哪些响应会触发重试，请参阅测试与集成指南。
Payload
显示随 API 调用发送的原始 JSON 数据。
Danger Zone
- 删除日志记录 — 永久删除此日志记录
- 记录本体及其关联的 Payload 会被一并删除。此操作不可撤销
- 不会影响使用统计
查看端点快速链接
详细页面右侧显示一张快速链接卡片，用于跳转到当前日志对应的端点详情页面。您可以快速确认端点的设置、Webhook、协作密钥等。
常见问题
- 日志为空：在生产部署之前，生产环境标签页不会显示任何记录。请先在沙盒环境标签页确认测试调用是否已被记录
- 搜索无结果：搜索词少于 3 个字符，或所选日期范围内没有匹配的记录。(1) 把关键词改短或更具体（中文 2–3 字、英文用单词的一部分）；(2) 将时间范围扩展到 30 天以内。过去的 "可搜索字段" 配置步骤已废弃，无需为每个字段单独设置。
- 想仅查看某位协作者的调用：在时间段搜索标签页的 协作密钥 下拉菜单中选择该协作密钥
- Webhook 列是空的，是不是表示投递成功了？：不是。系统只记录失败的投递，因此空白表示"没有失败记录"。未配置 Webhook、尚未尝试投递、以及投递成功，三种情况看起来完全一样
- 打开 Webhook 失败筛选后搜索词消失了：
Webhook 失败的查询方向相反，因此无法与请求 ID、内容搜索同时使用。时间范围和协作密钥条件会保留 - 沙盒清除可以撤销吗？：不可以。被清除的沙盒调用记录和统计会被永久删除，请谨慎使用