3Min API
菜单路径: 仪表盘 > APIs > 端点名称

端点详情

概述

端点详情是处理单个端点所有设置的页面。在这一个页面上您可以：

  • 查看和编辑端点信息（名称、描述、URL、版本）
  • 切换激活 / 停用
  • 部署和重新部署到生产环境
  • 管理默认 API 密钥
  • 添加和删除必填字段
  • 配置 Webhook 和系统通知
  • 删除端点

协作密钥管理（签发密钥、邀请、权限）在单独的页面处理。详情请参阅协作密钥。

如果您以协作者身份参与，只会显示您有权限访问的部分（所有者专属部分自动隐藏）。

如何进入

端点列表页

  • 顶部菜单 APIs → 点击列表中的端点名称
  • 仪表盘最近活动 → 点击端点
  • 完成新手引导步骤 1 后自动跳转

免费套餐警告横幅

免费套餐横幅

使用免费套餐时显示在顶部。免费套餐下可以随意创建和试用端点。端点会在创建 7 天后自动清理，但您随时可以创建新的——放心尝试。

激活/停用和部署按钮

页眉操作区域

仅所有者可见。

  • 激活/停用按钮（电源图标）：当您想要临时暂停所有环境的 API 调用时使用。停用期间调用被拒绝，但数据保留。
  • 部署到生产环境 按钮（仅沙盒环境标签页）：
    • 将当前沙盒环境设置复制到生产环境
    • 条件：必须在沙盒环境中完成至少 1 次测试调用后才可激活

如果协作者访问此页面，会显示 请求部署 按钮，向所有者发送部署请求消息。

环境标签页

环境标签页

页眉栏下方有 沙盒环境 | 生产环境 标签页。两个环境完全独立。

推荐的工作流程是：在沙盒环境中测试并与协作者讨论 → 部署到生产环境 → 运营。需要变更时，先在沙盒环境修改再重新部署。

沙盒环境

  • 使用沙盒环境 API 密钥（tm_test_）调用的环境
  • 仅用于测试。上线前可以自由试验
  • 沙盒环境数据30 天后自动删除（所有套餐）

生产环境

  • 使用生产环境 API 密钥（tm_live_）调用的环境
  • 用于正式运营。账户有效期间数据永久保留。超过 30 天的记录自动归档（付费套餐）
  • 生产环境部署前，生产环境密钥调用将被拒绝且不记录日志

概览卡片

概览卡片

包含端点基本信息的区域。

项目 说明
描述 端点描述。所有者可在沙盒环境标签页内联编辑
端点 URL 实际 API 调用地址。**向此 URL 发送 POST/GET/PUT/DELETE 请求。**提供复制按钮
版本 配置版本。每次部署递增
创建时间 端点创建时间
更新时间 最后一次设置变更时间（沙盒环境）
发布时间 生产环境部署时间（仅生产环境标签页）

默认 API 密钥

仅所有者可见。

默认 API 密钥

  • 端点创建时签发的默认 API 密钥
  • 用于测试与集成指南页面的认证，可通过右侧的立即测试按钮访问
  • 显示 / 隐藏 切换，在屏幕上隐藏或显示密钥
  • 重新生成 按钮：旧密钥立即失效。仅在怀疑泄露时使用

协作者访问时，此区域替换为其分配的协作密钥卡片。

协作密钥

协作密钥

此处仅提供摘要卡片——密钥创建、邀请和权限管理在单独的管理页面进行。

  • 所有者视图：查看全部 按钮和每个协作者的摘要（名称、邀请数）
  • 协作者视图：分配给您的密钥的权限标签

详细说明请参阅协作密钥。

必填字段

必填字段

定义 API 调用中必须包含的 JSON 字段。详细说明请参阅创建新端点。

  • 要添加或编辑字段，点击 编辑 按钮
  • 编辑时可以添加、删除和更改字段类型。完成后点击 保存 或 取消
  • 保存后更新沙盒环境配置——要应用到生产环境，需要重新部署
  • 即使部署后，修改必填字段不影响已存储的数据。更新的字段规则仅适用于新的传入调用

Webhook

仅所有者可见。

Webhook 设置

API 调用成功处理后，可以向指定的 Webhook URL 发送二次请求。无论 Webhook 是否成功，数据存储始终完成。

输入字段

  • Webhook URL：接收 Webhook 的地址（推荐 HTTPS）
  • Auth Header（可选）：认证头键。默认 Authorization
  • Auth Value（可选）：认证头值。示例：Bearer abc123

对于不需要认证的 Webhook（简单接收器、URL 中嵌入 Token 等），留空认证字段即可。

Webhook 策略摘要

  • 重试：失败后最多重试 3 次，1 秒 → 2 秒退避
  • 超时：必须在 7 秒内响应。超时视为失败

Webhook Payload

API 调用处理后，以下 JSON Payload 将发送到 Webhook URL。您可以展开截图中的 Webhook Payload 示例 区域查看实际格式。

字段 说明
id 存储记录的唯一 ID
operation 执行的操作（create、update、delete）
status 处理结果（success、failed）
endpoint_slug 端点标识符
payload 调用者发送的原始 JSON 数据，原样包含（delete 时为 null）
target_record_id 目标记录 ID（update/delete 时包含）
processed_at 处理完成时间

协作者 Webhook

如果协作者需要 Webhook，可以在 API 请求中包含 X-Webhook-Callback 等头信息来设置自己的 Webhook。协作者 Webhook 与所有者 Webhook 独立运行，Payload 格式相同。详细设置说明请参阅测试与集成指南。

通知

通知设置

与 Webhook 分开，此功能仅将系统事件发送到 Discord、Slack 或 Telegram。不包含请求 Payload——只通知发生了什么事件。

结构

  • 无环境标签页区分：通知设置按端点管理，不按环境区分
  • 所有者视图：单个通知设置卡片
  • 协作者视图：按分配的协作密钥显示通知卡片

输入字段

  • 频道：Discord / Slack / Telegram
  • Webhook URL：在各平台预先配置的 Bot/Webhook URL
  • Chat ID：仅 Telegram 需要

Webhook/Bot 的设置说明请参考各平台的官方文档。

通知事件

事件 接收者 说明
Webhook 发送失败（仅限自己的 Webhook） 受影响方 所有者 Webhook 失败 → 所有者 / 协作者 Webhook 失败 → 协作者
月度使用量 80% 警告（仅限所有者） 所有者 月度使用量达到 80%
月度使用量超出限额（仅限所有者） 所有者 月度使用量超过 100%
新的部署请求（仅限所有者） 所有者 协作者请求了生产环境部署
部署完成（仅限协作者） 协作者 所有者完成了部署

注意

  • 通知发送失败不会重试，也不存储发送记录
  • 所有通知消息均为英文

危险区域

仅所有者可见。

危险区域

  • 删除端点 按钮
  • 删除后立即且永久移除：
    • 端点配置本身
    • 沙盒环境和生产环境的所有 API 记录
    • 相关统计 / 部署请求 / Webhook / 通知设置 / 协作密钥 / 归档元数据
  • 协作者也将失去访问权限
  • 无法撤销 — 确认对话框中必须输入端点名称才能继续

右侧边栏

详情页右侧根据环境显示不同的快捷卡片。

API 调用记录

查看日志

跳转到可以查看该端点 API 调用结果的页面。您可以详细查看请求成功/失败、Payload、Webhook 状态等。

沙盒环境测试

在沙盒环境标签页显示。

沙盒环境测试

跳转到可以直接在浏览器中测试 API 调用和查看集成方法的页面。详情请参阅测试与集成指南。

生产控制台

在生产环境标签页显示，部署后仅所有者可见。

生产控制台

直接从仪表盘管理生产环境数据的控制台。适用于预先填充产品列表或公告，供协作者通过 GET 获取。支持 POST（创建）、GET（读取）、PUT（更新）和 DELETE（删除）。控制台使用所有者的 API 密钥运行，不会触发协作者 Webhook。如果配置了所有者 Webhook，则正常触发。详情请参阅生产控制台。

部署请求通知

在沙盒环境标签页显示。

部署请求通知

协作者请求了生产环境部署时显示。该通知也会通过邮件发送，不会错过。点击 查看全部 按钮查看完整的部署请求历史。

常见问题

  • 部署按钮被禁用：可能是沙盒环境中没有进行过测试调用，或者最新的沙盒环境版本已经部署到了生产环境。请先在沙盒环境中运行测试
  • 生产环境标签页没有记录：部署前生产环境调用会被拒绝，因此不记录日志。请检查部署是否成功，以及是否使用了 tm_live_ 密钥
  • 必填字段已更改但未反映在生产环境：沙盒环境的更改不会自动应用到生产环境。请再次点击 部署到生产环境
  • Webhook 未到达：Webhook 服务器必须在 7 秒内响应。请检查服务器是否可公开访问且使用 HTTPS。Discord 和 Slack 等平台有自己的速率限制——如果短时间内触发了过多 Webhook，部分可能会被拦截。请同时检查接收平台的速率限制策略
上一篇
创建新端点
下一篇
协作密钥