用途:该技能面向需要构建稳健 MaintainX API 集成的开发者,提供生产级代码模式,包括错误处理、游标分页、重试逻辑与类型安全。前置条件为已完成 maintainx-install-auth 配置,并熟悉 TypeScript/Node.js 与 REST API 原理。
主要能力:一是类型安全客户端,基于 axios 封装 MaintainXClient,内置 WorkOrder、Asset 等 TypeScript 接口,通过环境变量 MAINTAINX_API_KEY 鉴权,基址为 https://api.getmaintainx.com/v1,支持工单与资产的增删改查及通用 request 方法。二是游标分页,MaintainX 使用 cursor 分页,响应含 cursor 字段,将其作为查询参数传入即可获取下一页,paginate 工具可跨列表端点收集全部条目。三是重试机制,withRetry 对 429 与 5xx 采用指数退避,并优先遵循 Retry-After 响应头。四是批量操作,借助 p-queue 控制并发与速率,避免触发限流。五是链式查询构建器 WorkOrderQuery,按状态、优先级、指派人、资产、位置、创建时间与 limit 组合过滤条件。
使用方式:按步骤依次实现类型安全客户端、分页工具、重试封装、批量处理器与查询构建器;示例中通过 client.getWorkOrders、createWorkOrder、updateWorkOrder、getAssets 等方法调用,并可用异步迭代器流式处理大数据集。
适用场景:工单与资产的批量拉取、预防性维护工单批量创建、需要限流与容错的后台同步任务。
限制:资料未提供具体速率上限、配额、价格或平台支持范围;示例依赖 axios 与 p-queue 等外部库,需自行安装;代码中的接口字段与端点以资料为准,实际使用前应核对官方 API 参考。