SuperAPI AI 工具集

appfolio-common-errors

编程与开发

查看项目

更新于 10-15 22:42

技能介绍

用途:该技能面向 AppFolio Stack API 集成排障,帮助按认证、限流、校验、服务器故障四类对响应分类,并给出恢复决策。适用于物业管理集成中的租户查询、工单、租约与账务接口问题。

主要能力:提供错误参考表,涵盖 401(凭据无效或轮换)、403(未获 Stack 合作伙伴批准)、404(租户未找到,常见于投资组合基础 URL 错误)、409(同一单元租约日期重叠)、422(工单或租户缺少必填字段)、429(超过每分钟 120 次请求)、500 与 503(平台故障或维护窗口)。附带错误分类函数示例,将状态码映射为 auth、rate_limit、validation、server 四类。

使用方式:先按状态码分类并仅保留脱敏诊断字段;404 时先核对 {company}.appfolio.com/api/v1 基础 URL 再改凭据;409 或部分写入失败时查询规范记录并使用幂等键或人工复核;429 遵循 Retry-After 并在重试预算内停止;5xx 或写入结果未知时暂停批次。文档给出使用 netrc 文件避免在命令行暴露 Basic Auth 凭据的连通性检查命令。

适用场景:多投资组合集成、批量租户查询、工单导入、租约创建等。

限制:需准备脱敏事件记录、沙箱或生产端点访问、可轮换凭据的负责人、有界重试策略与幂等机制;不得在共享工单中复制租户或租约数据。限流按 API 密钥而非按投资组合计算,多投资组合共享同一预算。单元 ID 与投资组合绑定,不能跨子域复用。具体收费、价格与平台支持范围资料未提供。