核心用法
本技能通过 Maton 网关代理接入 Jobber GraphQL API，实现现场服务业务的全面数字化管理。用户需先获取 Maton API Key 并完成 OAuth 授权，即可调用丰富的业务操作接口。
主要功能模块：
- 客户管理：创建、查询、更新客户档案，支持邮箱、电话、账单地址等完整信息
- 工单调度：管理服务工作工单，包含状态追踪、服务说明、关联客户与房产
- 财务流程：生成报价单、创建发票、追踪付款状态，形成完整业务闭环
- 资产管理：维护服务房产地址信息，支持多地址客户场景
- 团队协作：查询团队成员信息，辅助任务分配
技术特性：
- 纯 GraphQL 接口，支持精准字段查询与复杂嵌套
- 自动注入 API 版本头（2025-04-16），保障兼容性
- Relay 风格游标分页，高效处理大数据集
- Webhook 实时事件推送，支持业务自动化
显著优点
1. 托管 OAuth 简化集成：无需自建认证流程，Maton 网关自动处理令牌刷新与安全管理
2. 现场服务垂直优化：数据模型深度贴合保洁、维修、园艺等行业需求，如 property-job-invoice 关联设计
3. 弹性连接管理：支持多账户连接切换，通过 Maton-Connection 头灵活指定工作上下文
4. 成本可控的查询：GraphQL 精确字段选择避免过度获取，配合点数限速算法（10,000 点桶/500点/秒恢复）保障公平使用
潜在局限
1. GraphQL 学习门槛：相比 REST，需理解 Schema、Resolver、嵌套查询等概念
2. 速率限制严格：DDoS 防护 2500 请求/5分钟，复杂查询可能快速消耗点数配额
3. ID 编码特殊：采用 Base64 EncodedId，需字符串化处理，调试时不够直观
4. 网关依赖风险：所有流量经 Maton 网关代理，单点故障或政策变更可能影响服务
适合人群
- 现场服务企业的技术负责人或系统管理员
- 需要集成 Jobber 到内部 CRM/ERP 的开发团队
- 构建行业 SaaS 解决方案的 ISV（独立软件开发商）
- 自动化工作流编排的技术运营人员
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据权限 | OAuth 范围配置不当可能导致过度授权，需定期审计连接权限 |
| 密钥泄露 | MATON_API_KEY 泄露可导致账户数据暴露，建议使用密钥管理服务 |
| 计费失控 | 高频 Webhook 或轮询查询可能触发速率限制，影响业务连续性 |
| 版本漂移 | Jobber API 12-18 个月弃用旧版本，需关注版本升级通知 |
| 环境变量问题 | curl 管道到 jq 时环境变量可能无法展开，建议优先使用 Python/JS SDK 方式 |