SuperAPI AI 工具集

appfolio-rate-limits

编程与开发

查看项目

更新于 10-15 22:42

技能介绍

用途:处理 AppFolio Stack API 的按合作伙伴限流,避免批量租户导入、租金表同步、工单批更新等高频操作耗尽配额,尤其适用于跨数百单元、月结期间并发高峰的物业管理系统同步。

主要能力:按端点设置限速上限并保持并发低于最小配额;每次请求前获取令牌,遵守 Retry-After,带抖动限制重试次数;以持久化游标和幂等键处理写操作,不因响应丢失而重放租户创建;在重试预算耗尽、进入维护窗口或写结果未知时暂停并升级批次。资料提供令牌桶限速类、重试函数与批量同步示例。

限流参考:房源列表/获取 120 请求/分钟;租户创建/更新 30 请求/分钟;工单 60 请求/分钟;批量导出 5 请求/小时;Webhook 注册 10 请求/分钟,均为按合作伙伴密钥。

使用方式:以具体端点合同或响应头确认限额,不用通用值;为每个写操作准备幂等键和持久化游标;设置 limiter 并在请求前 acquire;对 429 按 Retry-After 退避,对 5xx 指数退避,超限则抛出。批量同步按 batchSize 分批并延时。

限制与前置条件:需已验证的端点限额、幂等键、运维暂停策略、分段测试环境与请求预算负责人;勿在生产租户上验证重试与未知写入。资料未提供官方文档链接与完整实现细节。