用途:为 AppFolio 物业管理 REST API 集成提供生产级实现模式。AppFolio 使用 HTTP Basic Auth(客户端凭证)并返回 JSON,覆盖房产、租户、租约和工单等端点。
主要能力:单例客户端集中凭证、超时与错误处理;查询构建器限制分页与查询边界;类型化响应(Property、Tenant、Lease、WorkOrder);safeCall 错误封装区分 429 限流、401 认证与一般 API 错误;用于单元测试的合成 mock 工具。
使用方式:每个运行期构建一个受契约约束的客户端,配置缺失或无效时在请求前拒绝。查询与响应形状在服务边界校验,只向调用方传递最小化的类型字段。429 或未知写入失败返回给调用方,仅对幂等操作在记录游标/键与延迟后重试。写入流程须有明确授权、审计与对账控制。需要提供方验证的基础 URL、认证方式、端点范围与受管密钥注入路径。
适用场景:房产、租户、租约、工单列表读取与幂等批量操作;需要统一限流、超时和错误分类的集成。
限制:生产租户、租约和支付载荷不得作为默认 mock、日志或错误信息内容;未验证配置、响应模式或写入结果时应停止流程并报告脱敏错误。具体端点、价格、平台支持等资料未提供。