用途:为 MaintainX REST API 集成搭建认证与开发环境,属于 CMMS(计算机化维护管理系统)对接的初始化步骤。
主要能力:指导生成 API 密钥、配置环境变量、创建 Node.js(axios)或 Python(requests)客户端封装,并提供连接验证与错误处理说明。
使用方式:先在 https://app.getmaintainx.com 的 Settings > Integrations 生成密钥;设置环境变量 export MAINTAINX_API_KEY="your-api-key-here",多组织场景另设 MAINTAINX_ORG_ID;客户端基址为 https://api.getmaintainx.com/v1,请求头使用 Authorization: Bearer 与 X-Organization-Id。可用 curl 快速验证:curl -s https://api.getmaintainx.com/v1/users?limit=1 -H "Authorization: Bearer $MAINTAINX_API_KEY" | jq .。
适用场景:新建 MaintainX 集成、配置 API 密钥、初始化 API 客户端,以及多设施多组织令牌管理。
限制:需 Node.js 18+ 或 Python 3.10+,MaintainX 账户需具备 API 访问权限(Professional 或 Enterprise 计划)及管理员权限;密钥仅显示一次,须妥善保存,不得提交至版本控制,建议定期轮换。常见错误包括 401(密钥无效)、403(权限不足)、404(端点错误)与网络错误(需放行 443 出站)。