SuperAPI AI 工具集

appfolio-install-auth

编程与开发

查看项目

更新于 10-16 06:20

技能介绍

用途:配置 AppFolio Stack API 认证。AppFolio 使用 HTTP Basic Auth,凭据来自 Stack 合作伙伴计划;没有公开的 npm SDK,需直接调用 REST API。

前提:AppFolio Stack 合作伙伴账户(appfolio.com/stack)、AppFolio 签发的 Client ID 与 Client Secret、Node.js 18+ 或 Python 3.10+。

使用方式:先在 appfolio.com/stack/become-a-partner 申请,完成集成审核后获得提供方签发的 base URL 和凭据交付说明,将值存入批准的密钥管理器。本地开发可只提交非密钥模板: cat > .env.example << 'ENVFILE' APPFOLIO_CLIENT_ID= APPFOLIO_CLIENT_SECRET= APPFOLIO_BASE_URL= ENVFILE .env 保持忽略,仅通过批准的本地密钥流程填充。随后创建 TypeScript REST 客户端(axios),将 baseURL 设为 APPFOLIO_BASE_URL,auth 使用 client id/secret,超时 30000 毫秒,并提供 verifyConnection 读取 /properties 验证连通性。也可用临时 netrc 文件配合 curl 做脱敏诊断,仅打印状态码。

主要端点:Properties、Units、Tenants、Owners、Vendors、Reports 为 GET;Leases、Bills 支持 GET 与 POST,路径前缀为 /api/v1。

限制与错误:401 为凭据无效;403 表示非 Stack 合作伙伴;404 通常是 base URL 错误(应为 your-company.appfolio.com 格式);超时需检查防火墙是否允许 HTTPS 访问 appfolio.com。首次认证演练应仅做只读请求,日志中不得打印属性负载、client ID、密钥或完整主机路径;若契约、base URL、密钥绑定或状态结果未验证,应在任何写入流程前停止并交由凭据负责人修正。资料未提供具体价格或配额信息。