appfolio local dev loop | sed 's/\b(.)/\u\1/g'
概述
AppFolio API 集成本地开发工作流程,支持模拟数据与沙箱测试。
操作说明
第 1 步:项目初始化
mkdir appfolio-integration && cd appfolio-integration
npm init -y
npm install axios dotenv typescript @types/node
npm install -D vitest msw # 用于 API 模拟
第 2 步:Mock 服务器
// src/dev/mock-server.ts
import express from "express";
const app = express();
app.use(express.json());
const mockProperties = [
{ id: "1", name: "Sunset Apartments", address: { street: "123 Sunset Blvd", city: "Los Angeles", state: "CA" }, property_type: "residential", unit_count: 24 },
{ id: "2", name: "Downtown Office", address: { street: "456 Main St", city: "San Francisco", state: "CA" }, property_type: "commercial", unit_count: 8 },
];
app.get("/api/v1/properties", (req, res) => res.json(mockProperties));
app.get("/api/v1/tenants", (req, res) => res.json([
{ id: "t1", first_name: "Jane", last_name: "Smith", email: "[email protected]", unit_id: "u1" },
]));
app.get("/api/v1/leases", (req, res) => res.json([
{ id: "l1", unit_id: "u1", start_date: "2025-01-01", end_date: "2026-01-01", rent_amount: 2500, status: "active" },
]));
app.listen(3001, () => console.log("Mock AppFolio API on :3001"));
第 3 步:开发脚本
{
"scripts": {
"dev:mock": "tsx src/dev/mock-server.ts",
"dev:test": "APPFOLIO_BASE_URL=http://localhost:3001/api/v1 tsx src/hello-world.ts"
}
}