AppFolio Webhook 事件 | 首字母大写处理
概述
AppFolio Stack 支持租约、付款和维护事件的 webhook。
Webhook 处理器
import express from "express";
import crypto from "crypto";
const router = express.Router();
router.post("/webhooks/appfolio", express.raw({ type: "application/json" }), (req, res) => {
const signature = req.headers["x-appfolio-signature"] as string;
const expected = crypto.createHmac("sha256", process.env.APPFOLIO_WEBHOOK_SECRET!)
.update(req.body).digest("hex");
if (!crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected))) {
return res.status(401).json({ error: "无效签名" });
}
const event = JSON.parse(req.body.toString());
console.log(`事件: ${event.type} — ${JSON.stringify(event.data)}`);
res.status(200).json({ received: true });
});
事件类型
| 事件 | 触发条件 | 使用场景 |
|---|---|---|
lease.created | 新租约签署 | 更新CRM |
lease.expired | 租约到期 | 触发续租流程 |
payment.received | 租金已支付 | 更新会计记录 |
maintenance.created | 提交维修工单 | 调度供应商 |