SuperAPI AI 工具集

maintainx-webhooks-events

通用与其它

查看项目

更新于 10-15 23:27

技能介绍

用途:构建与 MaintainX 的实时集成,通过 Webhook 接收工单更新、资产变更和维护通知等事件。

主要能力:注册、列出和删除 Webhook;接收并路由 workorder.created、workorder.updated、workorder.status_changed、workorder.completed 等事件;使用 HMAC SHA-256 校验 x-maintainx-signature 签名;通过 x-maintainx-event-id 做幂等去重;提供 Express 接收端、事件路由和幂等存储示例;支持用 ngrok 暴露本地服务进行调试;Webhook 不可用时可用轮询回退。

使用方式:需 MaintainX 账号与 API 访问权限、可公网访问的 HTTPS 端点,并配置 MAINTAINX_API_KEY 环境变量。注册示例:curl -X POST https://api.getmaintainx.com/v1/webhooks -H "Authorization: Bearer $MAINTAINX_API_KEY" -H "Content-Type: application/json" -d '{"url":"https://your-app.example.com/webhooks/maintainx","events":["workorder.created","workorder.updated","workorder.status_changed","workorder.completed"]}'。本地调试可运行 npm run dev 后执行 ngrok http 3000,再用返回的 HTTPS 地址注册。

适用场景:工单状态同步到 ERP 或数据仓库、高优先级工单触发 Slack 告警、生成完成报告等实时集成。

限制:资料未提供具体收费、价格、平台支持范围或性能指标;生产环境建议用 Redis 等持久化存储替代内存 Map;签名校验需使用原始请求体,否则会校验失败。