用途:在 MaintainX 中执行核心维护流程,即工作订单(Work Order)从创建到完成的全生命周期管理。
主要能力:创建纠正性工单并指定标题、描述、优先级、状态、指派人、资产、位置、截止时间与分类;按状态流转更新工单(OPEN→IN_PROGRESS→COMPLETED→CLOSED,可经 ON_HOLD 暂停或取消后关闭);查询与分页获取工单;添加工单评论与文件附件;将工单指派给用户或团队;批量创建预防性维护工单;按创建时间范围过滤工单。
使用方式:需先完成 maintainx-install-auth 安装认证配置,并设置 MAINTAINX_API_KEY 环境变量,账号须具备工单权限。通过 MaintainXClient 调用 createWorkOrder、updateWorkOrder、getWorkOrders,以及直接请求 comments、files、teams 等端点。例如查询工单可用 curl 请求 https://api.getmaintainx.com/v1/workorders,并携带 Authorization: Bearer $MAINTAINX_API_KEY 头。
适用场景:设备维护与设施管理中的纠正性和预防性维护工单流程、现场技师的工单执行与记录。
限制与错误处理:400 表示缺少 title;404 表示资产、位置或用户 ID 无效;403 表示权限不足;422 表示非法状态转换,例如从 CLOSED 回到 OPEN,需遵循状态流转顺序。资产与位置管理见 maintainx-core-workflow-b。其他收费、价格等信息暂未提供。