Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

Maneja los límites de tasa de la API de AppFolio con throttling y retroceso.

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

Esta habilidad para agentes de IA gestiona los límites de tasa de la API de AppFolio Stack, cruciales para operaciones de alto volumen como importaciones masivas de inquilinos, sincronización de rentas y actualizaciones por lotes de órdenes de trabajo. Proporciona un limitador de tasa por punto final, una estrategia de reintentos con retroceso exponencial y jitter, y un procesamiento por lotes con claves de idempotencia. Es útil para administradores de propiedades que realizan sincronizaciones nocturnas y necesitan evitar la degradación del servicio durante picos de carga, como fin de mes. Soporta la implementación en TypeScript y se integra con sistemas de persistencia para reanudar lotes pausados. La habilidad se basa en el manejador de límites de AppFolio, documentado en la especificación de la API Stack, y está diseñada para ser configurada por contrato de socio, no con valores genéricos.

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-rate-limits

Preguntar en tu IA favorita

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

Documentación

Límites de Tasa de AppFolio

Resumen

La API Stack de AppFolio impone límites de tasa por socio para proteger la infraestructura compartida de gestión de propiedades. Las operaciones de alto volumen, como importaciones masivas de inquilinos, sincronizaciones de rentas y actualizaciones por lotes de órdenes de trabajo, pueden agotar rápidamente las cuotas. Los administradores de propiedades que ejecutan sincronizaciones de cartera nocturnas a través de cientos de unidades deben limitar cuidadosamente, especialmente durante fin de mes cuando las renovaciones de arrendamiento y el procesamiento de pagos aumentan simultáneamente.

Requisitos Previos

  • Un límite verificado por punto final del contrato actual de socio de AppFolio o de los encabezados de respuesta; no confíes en un valor genérico de tasa para escrituras de inquilinos.
  • Cursores de lote persistidos, claves de idempotencia para cada escritura y una política del operador para pausar cargas de trabajo de fin de mes u otras sensibles a la seguridad.
  • Un fixture de staging y un propietario del presupuesto de solicitudes que pueda probar reintentos, comportamiento de "429" y manejo de escrituras desconocidas sin tocar inquilinos en producción.

Instrucciones

  1. Selecciona el techo del limitador para el punto final específico y mantén la concurrencia por debajo del límite de cartera o socio aplicable más pequeño.
  2. Adquiere un token antes de cada solicitud, respeta Retry-After y limita los reintentos con jitter para fallos transitorios del proveedor.
  3. Procesa escrituras desde un cursor persistido con claves de idempotencia; nunca reproduzcas una creación de inquilino solo porque se perdió la respuesta.
  4. Pausa y escala lotes que agoten el presupuesto de reintentos, encuentren una ventana de mantenimiento o tengan un resultado de escritura desconocido.

Referencia de Límites de Tasa

Punto finalLímiteVentanaÁmbito
Lista/obtén propiedades120 solicitudes1 minutoPor clave de socio
Crear/actualizar inquilino30 solicitudes1 minutoPor clave de socio
Órdenes de trabajo60 solicitudes1 minutoPor clave de socio
Exportación masiva de datos5 solicitudes1 horaPor clave de socio
Registro de webhooks10 solicitudes1 minutoPor clave de socio

Implementación del Limitador de Tasa

class AppFolioRateLimiter {
  private tokens: number;
  private lastRefill: number;
  private readonly maxTokens: number;
  private readonly refillRate: number; // tokens per ms

  constructor(maxPerMinute: number) {
    this.maxTokens = maxPerMinute;
    this.tokens = maxPerMinute;
    this.lastRefill = Date.now();
    this.refillRate = maxPerMinute / 60_000;
  }

  async acquire(): Promise<void> {
    for (;;) {
      this.refill();
      if (this.tokens >= 1) {
        this.tokens -= 1;
        return;
      }
      // Wait until the next token is available; no later request is needed to
      // wake this caller.
      const waitMs = Math.max(1, Math.ceil((1 - this.tokens) / this.refillRate));
      await new Promise(resolve => setTimeout(resolve, waitMs));
    }
  }

  private refill() {
    const now = Date.now();
    this.tokens = Math.min(this.maxTokens, this.tokens + (now - this.lastRefill) * this.refillRate);
    this.lastRefill = now;
  }
}

const limiter = new AppFolioRateLimiter(25); // configure per endpoint contract

Estrategia de Reintentos

async function appfolioRetry<T>(fn: () => Promise<Response>, maxRetries = 4): Promise<T> {
  for (let attempt = 0; attempt <= maxRetries; attempt++) {
    await limiter.acquire();
    const res = await fn();
    if (res.ok) return res.json();
    if (res.status === 429) {
      const retryAfter = parseInt(res.headers.get("Retry-After") || "10", 10);
      const delay = retryAfter * 1000 + Math.random() * 2000;
      await new Promise(r => setTimeout(r, delay));
      continue;
    }
    if (res.status >= 500 && attempt < maxRetries) {
      await new Promise(r => setTimeout(r, Math.pow(2, attempt) * 1000));
      continue;
    }
    throw new Error(`AppFolio API ${res.status}: ${await res.text()}`);
  }
  throw new Error("Max retries exceeded");
}

Procesamiento por Lotes

async function batchSyncTenants(tenants: any[], batchSize = 25) {
  const results: any[] = [];
  for (let i = 0; i < tenants.length; i += batchSize) {
    const batch = tenants.slice(i, i + batchSize);
    const batchResults = await Promise.all(
      batch.map(t => appfolioRetry(() =>
        fetch(`${BASE}/api/v1/tenants`, {
          method: "POST", headers, body: JSON.stringify(t),
        })
      ))
    );
    results.push(...batchResults);
    if (i + batchSize < tenants.length) await new Promise(r => setTimeout(r, 2000));
  }
  return results;
}

Manejo de Errores

ProblemaCausaSolución
429 Demasiadas solicitudesLímite de tasa de socio excedidoRetroceso usando el encabezado Retry-After
403 en exportación masivaLímite de exportación por hora alcanzadoPoner en cola exportaciones con espacio de 15 minutos
Tiempo de espera en lista de propiedadesCartera grande (500+ unidades)Paginar con per_page=50
409 Conflicto en actualización de inquilinoEscritura concurrente al mismo inquilinoReintentar con nuevo ETag
503 durante mantenimientoVentana nocturna programada (2-4 AM PT)Omitir solicitudes, reintentar después de la ventana

Salida

  • Un limitador auto-programable y específico por punto final que no puede dejar trabajo en cola
  • Resultados de reintentos acotados con evidencia de Retry-After y datos de fallo redactados
  • Una decisión de lote persistida: completada, pausada para reintento posterior, o en cuarentena para conciliación del operador

Ejemplos

Para un lote de actualización de inquilinos en sandbox, configura el limitador por debajo del techo documentado de escritura de inquilinos, procesa un registro a la vez con claves de idempotencia y preserva el cursor después de cada resultado confirmado. Induce un 429 para probar que los llamados esperan y reanudan sin una solicitud adicional, luego induce una respuesta perdida para probar que el registro se pone en cuarentena en lugar de reproducirse ciegamente. Si los encabezados de tasa entran en conflicto con el techo configurado, los reintentos se agotan o comienza el mantenimiento, pausa el lote y entrega el cursor al propietario.

Recursos

Próximos Pasos

Consulta appfolio-performance-tuning.

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

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

jeremylongshore/tons-of-skills-marketplace

Apply production-ready patterns for AppFolio REST API integration. Trigger: "appfolio patterns".

Skills relacionados