maintainx-cost-tuning

用途：帮助已部署的 MaintainX 集成降低 API 请求量、优化调用成本，采用缓存、Webhook 驱动同步、请求批处理与智能轮询策略。前置条件：MaintainX 集成已部署可用，具备 Redis 或内存缓存，并有基线 API 用量指标。主要能力：按端点统计请求量并定期输出用量报告；按资源类型设置不同 TTL 的响应缓存（如 /users 300 秒、/assets 120 秒、/workorders 30 秒）；用 Webhook 替代轮询，将每日数千次请求降至约 50 次；不可用 Webhook 时用 updatedAtGte 条件做智能轮询；对并发的相同请求做去重。使用方式：在代码中引入用量跟踪器、缓存客户端，注册 Webhook 端点处理 workorder.updated/created 事件，并按需调整各资源 TTL。限制与注意：易变资源的 TTL 不宜过长；Webhook 投递失败可回退到较长间隔轮询；需设置缓存上限与 LRU 淘汰；重复 Webhook 事件应按事件 ID 去重。官方 API 文档与定价细节暂未提供。