appfolio-sdk-patterns

name	appfolio-sdk-patterns
description	Apply production-ready patterns for AppFolio REST API integration. Trigger: "appfolio patterns".
allowed-tools	Read, Write, Edit, Bash(npm:*), Bash(curl:*), Grep
version	1.0.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","property-management","appfolio","real-estate"]
compatible-with	claude-code

appfolio sdk patterns | sed 's/\b(.)/\u\1/g'

Overview

Production patterns for AppFolio API: typed client, pagination, response caching, and error handling.

Instructions

Step 1: Typed API Client

// src/appfolio/typed-client.ts
import axios, { AxiosInstance } from "axios";

interface Property {
  id: string; name: string; property_type: string;
  address: { street: string; city: string; state: string; zip: string };
  unit_count: number;
}

interface Tenant {
  id: string; first_name: string; last_name: string;
  email: string; phone: string; unit_id: string;
}

interface Lease {
  id: string; unit_id: string; tenant_name: string;
  start_date: string; end_date: string; rent_amount: number; status: string;
}

class  {
   : ;

  () {
    . = axios.({
      : process..,
      : { : process..!, : process..! },
      : ,
    });
  }

   (): <[]> {  ( ..()).; }
   (): <[]> {  ( ..()).; }
   (): <[]> {  ( ..()).; }
}

 { , , ,  };

Step 2: Response Cache

const cache = new Map<string, { data: any; expiry: number }>();

async function cachedGet<T>(client: AxiosInstance, path: string, ttlMs = 60000): Promise<T> {
  const cached = cache.get(path);
  if (cached && cached.expiry > Date.now()) return cached.data;
  const { data } = await client.get(path);
  cache.set(path, { data, expiry: Date.now() + ttlMs });
  return data;
}

Resources

• AppFolio Stack APIs
• AppFolio Engineering Blog