Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

Aplica patrones listos para producción para la integración con la API REST de AppFolio.

¿Qué es tons-of-skills-marketplace?

Este skill proporciona patrones de integración listos para producción para la API REST de administración de propiedades de AppFolio. Su objetivo es estandarizar el consumo de la API mediante un cliente singleton, manejo centralizado de errores, limitación de tasa y paginación. Es compatible con cualquier plataforma que pueda ejecutar TypeScript, como Claude Code, Cursor o Codex. El skill incluye un constructor de solicitudes con parámetros acotados, envoltorios de errores que clasifican respuestas 429 y 401, y utilidades de prueba con datos sintéticos. Al utilizarlo, los desarrolladores evitan la dispersión de credenciales, aseguran un manejo consistente de errores y riesgos de límite de tasa, y mantienen flujos de escritura controlados mediante autorización explícita y mecanismos de idempotencia.

Compatible con✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/HEAD/plugins/saas-packs/appfolio-pack/skills/appfolio-sdk-patterns

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Patrones del SDK de AppFolio

Descripción general

Patrones listos para producción para la API REST de administración de propiedades de AppFolio. AppFolio utiliza autenticación básica HTTP con credenciales de cliente y devuelve respuestas JSON para propiedades, inquilinos, contratos de arrendamiento y órdenes de trabajo. Un cliente singleton estructurado evita la dispersión de credenciales, impone un manejo de errores consistente y centraliza la lógica de paginación en todos los endpoints de administración de propiedades.

Requisitos previos

  • Una URL base verificada por el proveedor, método de autenticación, alcance del endpoint y ruta de inyección de secreto administrado para el portafolio objetivo.
  • Validación de esquema, tiempos de espera de solicitud, límites de tasa específicos del endpoint y claves de idempotencia para todos los métodos de servicio con capacidad de mutación.
  • Datos sintéticos para pruebas unitarias; las cargas útiles de producción de inquilinos, contratos y pagos no deben convertirse en contenido predeterminado de simulaciones, registros o mensajes de error.

Instrucciones

  1. Construir un cliente vinculado al contrato por tiempo de ejecución y rechazar configuraciones faltantes o inválidas antes de que comiencen las solicitudes.
  2. Validar los límites de consulta y las formas de respuesta en el límite del servicio, luego pasar solo campos tipificados minimizados a los llamadores.
  3. Devolver un 429 clasificado o un fallo de escritura desconocida al llamador; reintentar solo operaciones idempotentes después de que el llamador registre el cursor/clave y la demora.
  4. Mantener los flujos de escritura detrás de controles explícitos de autorización, auditoría y conciliación, en lugar de incrustarlos en ayudantes genéricos del SDK.

Cliente Singleton

import axios, { AxiosInstance } from 'axios';
let _client: AxiosInstance | null = null;
export function getClient(): AxiosInstance {
  if (!_client) {
    const clientId = process.env.APPFOLIO_CLIENT_ID;
    const clientSecret = process.env.APPFOLIO_CLIENT_SECRET;
    const baseURL = process.env.APPFOLIO_BASE_URL;
    if (!clientId || !clientSecret || !baseURL) throw new Error('APPFOLIO_CLIENT_ID, SECRET, and BASE_URL required');
    _client = axios.create({ baseURL, auth: { username: clientId, password: clientSecret }, timeout: 30000 });
  }
  return _client;
}

Envoltorio de Errores

export class AppFolioError extends Error {
  constructor(public status: number, public code: string, message: string) { super(message); }
}
export async function safeCall<T>(operation: string, fn: () => Promise<T>): Promise<T> {
  try { return await fn(); }
  catch (err: any) {
    const status = err.response?.status ?? 0;
    if (status === 429) {
      const retryAfter = err.response?.headers?.['retry-after'];
      throw new AppFolioError(429, 'RATE_LIMIT', `Reintentar después de ${retryAfter ?? 'demora dirigida por el proveedor'}; no reproducir una escritura desconocida automáticamente`);
    }
    if (status === 401) throw new AppFolioError(401, 'AUTH', 'APPFOLIO_CLIENT_ID o SECRET inválidos');
    throw new AppFolioError(status, 'API_ERROR', `${operation} falló [${status}]: ${err.message}`);
  }
}

Constructor de Solicitudes

class AppFolioQuery {
  private params: Record<string, string> = {};
  status(s: 'active' | 'past' | 'future') { this.params.status = s; return this; }
  propertyId(id: string) { this.params.property_id = id; return this; }
  page(n: number) { this.params.page = String(n); return this; }
  perPage(n: number) { this.params.per_page = String(Math.min(n, 200)); return this; }
  since(date: string) { this.params.updated_since = date; return this; }
  build() { return this.params; }
}
// Uso: new AppFolioQuery().status('active').perPage(50).build();

Tipos de Respuesta

interface Property {
  id: string; name: string; property_type: 'residential' | 'commercial' | 'mixed';
  address: { street: string; city: string; state: string; zip: string };
  unit_count: number; status: string;
}
interface Tenant {
  id: string; first_name: string; last_name: string;
  email: string; phone: string; unit_id: string; lease_id: string;
}
interface Lease {
  id: string; unit_id: string; tenant_id: string;
  start_date: string; end_date: string; rent_amount: number; status: 'active' | 'expired' | 'future';
}
interface WorkOrder {
  id: string; property_id: string; unit_id: string;
  description: string; priority: 'low' | 'medium' | 'high' | 'emergency';
  status: 'open' | 'in_progress' | 'completed';
}

Utilidades de Prueba

export function mockProperty(overrides: Partial<Property> = {}): Property {
  return { id: 'prop-001', name: 'Maple Ridge Apts', property_type: 'residential',
    address: { street: '100 Main St', city: 'Austin', state: 'TX', zip: '78701' },
    unit_count: 24, status: 'active', ...overrides };
}
export function mockLease(overrides: Partial<Lease> = {}): Lease {
  return { id: 'lease-001', unit_id: 'unit-001', tenant_id: 'ten-001',
    start_date: '2025-01-01', end_date: '2026-01-01', rent_amount: 1500, status: 'active', ...overrides };
}

Manejo de Errores

PatrónCuándo UsarloEjemplo
Envoltorio safeCallTodas las llamadas a la APIEvita que excepciones 4xx/5xx no capturadas interrumpan los flujos
Reintento propiedad del llamador en 429Lecturas por lotes idempotentes con límite de tasaConservar cursor/clave, respetar Retry-After, luego reintentar deliberadamente
Validación de autenticaciónInicialización del clienteLanza una excepción temprana si faltan credenciales
Bucle de paginaciónListado de propiedades/inquilinosIncrementar page hasta que la respuesta esté vacía

Salida

  • Un cliente API validado y vinculado al contrato con tiempo de espera centralizado y comportamiento de clasificación de errores
  • Parámetros de consulta acotados y respuestas tipificadas minimizadas para los llamadores del servicio
  • Resultados explícitos de límite de tasa y escritura desconocida que requieren decisiones de cursor/idempotencia/conciliación propiedad del llamador

Ejemplos

Para una lectura de lista de propiedades, construya una consulta con un tamaño de página limitado, ejecútela a través de safeCall, y verifique los IDs de propiedad devueltos y el recuento contra un dato sintético. Para una mutación, persista una clave de idempotencia antes del envío y trate un tiempo de espera o un 429 como una condición de pausa/conciliación en lugar de llamar a la función nuevamente. Si la configuración del cliente, el esquema de respuesta o el resultado de la escritura no están verificados, detenga el flujo de trabajo y muestre un error editado al propietario.

Recursos

Próximos Pasos

Aplicar patrones en appfolio-core-workflow-a.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

jeremylongshore/tons-of-skills-marketplace

Use when asked to structure a landing page for positioning, plan a conversion-optimized page layout, or design a launch page. Examples: "landing page for product launch", "conversion-optimized layout for SaaS

jeremylongshore/tons-of-skills-marketplace

Use when asked to design growth-optimized landing pages, activation funnel layouts, or experiment-friendly page structures. Examples: "growth-optimized landing", "activation funnel layout", "A/B testable page

jeremylongshore/tons-of-skills-marketplace

Use when asked to structure a landing page, design page layout for conversion, or plan landing page information architecture. Examples: "landing page structure for SaaS", "conversion-optimized layout

jeremylongshore/tons-of-skills-marketplace

Generate polished demo videos from a single prompt. Use when the user asks to create a demo video, product walkthrough, feature showcase, or animated presentation. Trigger with "make a demo video", "create a product video", "demo walkthrough", or "feature showcase video".

jeremylongshore/tons-of-skills-marketplace

Track cryptocurrency portfolio with real-time valuations, allocation analysis, and P&L tracking. Use when checking portfolio value, viewing holdings breakdown, analyzing allocations, or exporting portfolio data. Trigger with phrases like "show my portfolio", "check crypto holdings", "portfolio allocation", "track my crypto", or "export portfolio".

jeremylongshore/tons-of-skills-marketplace

Runs the full release workflow for the current project. Commits any uncommitted changes, pushes to remote, creates and merges a PR if on a feature branch, determines the next semver version from conventional commits, creates an annotated git tag and GitHub release with generated notes, cleans up merged branches, and returns to a clean main. Use when the user says promote, ship, release, commit and push, tag and release, or get back to main.

jeremylongshore/tons-of-skills-marketplace

Agent skill at plugins/productivity/content-multiplier/skills/channel-formats/SKILL.md

jeremylongshore/tons-of-skills-marketplace

Operate an evidence-backed editorial queue, balance topic and format coverage, schedule approved drafts, and reconcile backlog state with the publishing system. Use when choosing or scheduling the next blog work. Trigger with "show the editorial calendar" or "pick the next topic".

jeremylongshore/tons-of-skills-marketplace

Configure CI/CD pipeline for AppFolio property management integrations. Trigger: "appfolio CI".

jeremylongshore/tons-of-skills-marketplace

Diagnose and fix common AppFolio API integration errors. Trigger: "appfolio error".

jeremylongshore/tons-of-skills-marketplace

Build property management dashboard with AppFolio API data. Trigger: "appfolio property dashboard".

jeremylongshore/tons-of-skills-marketplace

Automate tenant management and lease operations with AppFolio. Trigger: "appfolio tenant management".

jeremylongshore/tons-of-skills-marketplace

Collect AppFolio API debug evidence for support tickets. Trigger: "appfolio debug".

jeremylongshore/tons-of-skills-marketplace

Deploy AppFolio integration service to cloud infrastructure. Trigger: "deploy appfolio".

jeremylongshore/tons-of-skills-marketplace

Query AppFolio properties, units, and tenants via REST API. Trigger: "appfolio hello world".

jeremylongshore/tons-of-skills-marketplace

Configure AppFolio Stack API authentication with OAuth 2.0. Use when setting up property management API access, registering as an AppFolio Stack partner, or configuring client credentials for API calls. Trigger: "install appfolio", "setup appfolio", "appfolio auth", "appfolio API key".

jeremylongshore/tons-of-skills-marketplace

Set up local development for AppFolio property management API integration. Trigger: "appfolio local dev".

jeremylongshore/tons-of-skills-marketplace

Production readiness checklist for AppFolio integrations. Trigger: "appfolio production checklist".

jeremylongshore/tons-of-skills-marketplace

Handle AppFolio API rate limits with throttling and backoff. Trigger: "appfolio rate limit".

jeremylongshore/tons-of-skills-marketplace

Reference architecture for AppFolio property management integration. Trigger: "appfolio architecture".

Skills relacionados