SuperAPI AI 工具集

appfolio-webhooks-events

办公与效率

查看项目

更新于 10-15 22:42

技能介绍

用途:把 AppFolio 物业管理生命周期事件(租户入驻、租约签署、租金支付、维修工单等)通过 webhook 实时同步到 CRM、会计系统或自建仪表盘,避免轮询 API。

主要能力:注册指定事件(如 tenant.created、work_order.updated、payment.received、lease.signed);对入站请求做基于 HMAC-SHA256 的签名校验;持久化事件后异步处理;通过持久化幂等避免重复副作用;对超时重试、重复事件、归档物业、存储不可用等情况给出处理方式。

使用方式:仅在当前 AppFolio 合作伙伴合同书面确认目标组合支持相应事件类型、注册流程、投递语义与签名方案后再注册,不得从其他集成推断支持。需准备有界原始报文入口、托管密钥、持久事件存储、队列、幂等表及下游负责人;上线前用沙箱端点和合成事件测试有效、畸形、重复与延迟投递。注册示例接口为向 /webhooks 提交 url、events、secret;校验时使用 express.raw 保留原始字节,提取 x-appfolio-signature 并用 timingSafeEqual 比较,失败返回 401;处理端点持久化成功返回 202,失败返回可重试的 503。

限制:资料未提供定价、平台版本、具体字段全量定义及可用事件完整清单。签名不匹配多因密钥错误或已解析报文,需用原始 body 校验;重复事件来自超时重试,应按事件 ID 幂等;缺少 property_id 可能来自归档物业,需先检查状态;持久存储或队列不可用时不得提前确认,应返回 503 重试。若缺少合同支持、原始报文捕获、签名密钥、持久存储或队列,应保持端点禁用,改用官方认可的轮询/对账路径。