跳转到内容

Webhook

通过 Webhook,您可以接收 Crowdin 项目中发生的关键事件的相关信息,例如译文已完成或校对。 当您配置 webhook 后,Crowdin 将开始通过 HTTP 向 webhook URL 发送带有数据的 POST 或 GET 请求。

您可以通过添加 webhooks 来建立与服务或与您后端的集成。 例如:

  • 设置 webhook 来向您的系统发送通知。
  • 向具有特定请求要求的第三方服务传递信息(例如,HTTP 方法、内容类型)。
  • 创建与 Crowdin 的自定义集成。

您可以为项目中发生的不同事件配置 webhook,例如,当文件被翻译、校对,或字符串被添加或更新时。

在 Crowdin 开发者门户上阅读更多关于 Webhook 事件的信息。

要在 Crowdin 中配置 webhook,请按照以下步骤操作:

  1. 打开您的项目并转到 工具 标签页(对于账户级别的 webhook,请打开您的 账户设置)。
  2. 选择 Webhooks 并单击 添加 Webhook
添加 Webhook

您需要提供以下信息才能注册 Webhook:

  • Webhook 名称(例如“应用程序项目已翻译”)
  • 要发布到指定 URL 的事件列表。 您可以选择任意一个或一组事件。
  • 作为直接请求发送 webhook 回调的目标 URL。 不支持重定向,重定向将导致传送失败。 端点必须在 30 秒内返回 2XX 响应。
  • 指示对给定资源执行所需操作的请求方法(使用 GETPOST)。
  • POST 请求方法的内容类型(multipart/form-dataapplication/jsonapplication/x-www-form-urlencoded)。
    • 对于 application/json 内容类型,您可以选择 批量 webhook 将多个事件合并为单个请求。

您可以选择为您的 webhook 添加特殊标头。 作为一种授权方法,它们可以用来提供更多的安全保障。 例如,如果添加标头,则 Webhook 终结点可以检查它们,以确保信息来自 Crowdin。

根据您的 Webhook 管理方法,您可能需要向防火墙添加专用的 Crowdin IP 地址,以允许 Crowdin 打开预配置的 Webhook URL。

详细了解 IP 地址

Crowdin 中的每种事件类型都有包含相关事件信息的特定载荷格式。 您可以自定义 webhook 载荷,按照系统要求的方式添加和组织元素。

要查看事件的可用变量,请将鼠标悬停在 载荷 部分右上角的 信息 图标上。

在特定项目中,您可以直接从显示的列表中编辑或删除已配置的 webhook,从而访问和管理它们。

编辑或删除 Webhook

调用历史 部分,您可以查看所有已配置 webhook 的调用列表。 使用筛选器查看所有或仅显示失败的 Webhook 通知。

调用历史

过去 24 小时内响应代码为 4xx 或 5xx 范围内且失败次数达到 100 次及以上的 Webhook 会被自动禁用。

已禁用的 webhook 会在 Webhooks 部分列出,并显示一个清除的勾选标记,表示它们当前由于持续失败而处于非活动状态。 要了解有关失败 webhook 的更多信息,请导航到 调用历史 > 失败 部分。 在这里,您可以探索有关每个失败的 Webhook 所遇到的问题的详细信息。

一旦您识别并解决了 Webhook 失败的原因,就可以手动重新启用 Webhook 以恢复其功能。 在 Webhooks 部分,找到已禁用的 webhook 并选择它进行重新启用。

借助 Crowdin webhook,您可以将预配置事件类型的通知直接发送到特定的 Slack 频道。

要配置向 Slack 发送 webhook,您需要创建一个简单的 Slack 应用。

阅读更多关于使用 Incoming Webhooks 向 Slack 发送消息的信息。

一旦您创建并配置了 Slack 应用,您将获得一个 Webhook URL,该 URL 应用于 Crowdin 中的 Webhooks 配置。

本页面对你有帮助吗?