用途:在 Lokalise 中注册 Webhook 端点,接收翻译事件(键新增/修改/删除、翻译更新/校对、文件导入导出、协作者增删等),并据此构建自动化流程。
主要能力:通过 POST /projects/{project_id}/webhooks 创建 Webhook,可订阅事件并用 event_lang_map 按语言过滤;响应含 secret,用于校验请求头 x-secret;示例提供 Express 处理器与事件路由;支持幂等去重;给出列表、更新、删除 Webhook 的 curl 示例。
使用方式:需 Lokalise 项目管理员或经理角色、可公网访问的 HTTPS 端点(HTTP 会被拒绝)、Express 等 HTTP 框架。创建时使用 X-Api-Token 认证。处理时先校验 x-secret,立即返回 200,再异步处理,避免 8 秒超时。本地测试可用 ngrok 暴露端口。
限制:Lokalise 超时 8 秒并按非 2xx 视为失败,会重试导致重复事件;连续失败会自动禁用 Webhook,需在仪表板检查。生产环境幂等存储建议用 Redis 等,而非内存 Set。未订阅的事件不会推送,需通过 PUT 更新。
分类:办公与效率。