AppFolio Webhook-Ereignisse | sed 's/\b(.)/\u\1/g'
Überblick
Der AppFolio Stack unterstützt Webhooks für Miet-, Zahlungs- und Wartungsereignisse.
Webhook-Handler
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: "Ungültige Signatur" });
}
const event = JSON.parse(req.body.toString());
console.log(`Ereignis: ${event.type} — ${JSON.stringify(event.data)}`);
res.status(200).json({ received: true });
});
Ereignistypen
| Ereignis | Auslöser | Anwendungsfall |
|---|---|---|
lease.created | Neuer Mietvertrag unterzeichnet | CRM aktualisieren |
lease.expired | Mietvertrag beendet | Verlängerungs-Workflow auslösen |
payment.received | Miete bezahlt | Buchhaltung aktualisieren |
maintenance.created | Arbeitsauftrag erstellt | Dienstleister beauftragen |