appfolio-hello-world

用途：作为 AppFolio Property Manager API 的首次集成检查，演示如何通过官方签发的托管客户端进行安全的只读查询，获取房产列表和指定房产下的租户记录数量。主要能力：封装一个 appfolioFetch 辅助函数，对响应状态码进行校验（仅接受 2xx，否则抛出错误），并依次调用 /properties?page_size=10 获取房产列表、调用 /tenants?property_id=... 获取租户记录。使用方式：需先配置经验证的 AppFolio 客户端，再执行读取；前置条件包括具备 API 访问权限的 AppFolio Stack Partner 账户、由提供方签发的托管基础 URL 与认证客户端、Node.js 18+ 与 TypeScript。适用场景：首个集成联通性验证，确认托管客户端与经批准的安全读取端点可用，输出仅包含房产 ID 和租户记录数量。限制：必须确认投资组合合同、安全读取夹具和响应授权均已验证，否则应停止运行并改用凭证所有者的暂存流程；不得猜测主机名或凭证方案；不得以创建工单等方式测试写入权限，写操作只能在单独批准的合成沙箱流程中进行；输出中不应记录地址、姓名、单元号或凭证。错误处理涵盖 401、403、404、422、429 等状态，分别对应凭证错误、权限不足、基础 URL 或端点错误、缺少必填字段以及触发限流（需增加退避延迟或批量请求）。