用途:为 AppFolio 集成提供生产就绪清单,适用于处理租户 PII、财务交易与工单流程的房地产运营集成在发布前做风险评估。触发词为“appfolio production checklist”。
主要能力:按四类检查项组织——认证与密钥(APPFOLIO_API_KEY 存入密钥管理器、客户端 ID 与密钥与应用代码分离、90 天轮换建议、环境隔离凭证、最小权限);API 集成(生产 base URL 与认证方式核对合同、指数退避限流、列表接口分页、工单创建必填字段、租约文档上传格式、Webhook 配置、幂等键);错误处理与韧性(断路器、429/5xx 退避重试、CCPA/FCRA 合规、响应数据校验、物业同步降级、重复工单检测);监控告警(按端点延迟、错误率 >3%/5 分钟告警、支付同步失败 P1、工单创建失败 5 分钟内上报、每日同步数量对账)。
使用方式:先在暂存环境跑就绪检查,再用生产形态客户端执行仅授权的安全读操作;通过密钥管理器校验实际客户端配置,不在发布代码中默认端点或认证方式。任一失败、跳过或不可验证的控制项均视为 no-go,保留脱敏凭证。仅在具备已测试的回滚与对账负责人时才渐进发布;支付、工单、租户或租约状态未知时暂停写入路径。附带 TypeScript 验证脚本示例,调用 /properties?limit=1 与 /work_orders?limit=1 输出 PASS/FAIL。
限制:需先具备已验证的生产合作伙伴合同、base URL、认证机制、允许的端点范围,以及业务、安全、运维与回滚决策的指定负责人;需完成合成数据沙箱演练。资料未提供具体价格、平台支持范围与更多实现细节。