Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

Gerencia limites de taxa da API AppFolio com controle de throttling e backoff.

O que é tons-of-skills-marketplace?

Esta skill oferece um gerenciamento robusto de limites de taxa para a API AppFolio Stack, essencial para operações de alto volume, como importações de inquilinos em massa, sincronizações de aluguel e atualizações em lote de ordens de serviço. Ela implementa um limitador de taxa baseado em token bucket, uma estratégia de retry com backoff exponencial e jitter, e processamento em lote com persistência de cursor e chaves de idempotência. A skill é projetada para plataformas como Claude Code, Cursor e Codex, e inclui referências detalhadas de limites por endpoint, tratamento de erros para códigos de status comuns (429, 403, 503) e orientações para testes em ambiente sandbox. O usuário pode configurar o limite máximo por minuto para cada endpoint e o sistema automaticamente adquire tokens, honra cabeçalhos Retry-After e pausa lotes que excedem o orçamento de tentativas ou encontram janelas de manutenção.

Funciona com✓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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Limites de Taxa do AppFolio

Visão Geral

A API Stack do AppFolio impõe limites de taxa por parceiro para proteger a infraestrutura compartilhada de gerenciamento de propriedades. Operações de alto volume, como importações em massa de inquilinos, sincronizações de aluguel e atualizações em lote de ordens de serviço, podem esgotar rapidamente as cotas. Gerentes de propriedades que executam sincronizações noturnas de portfólio em centenas de unidades precisam fazer throttling cuidadosamente, especialmente no final do mês, quando renovações de contratos de locação e processamento de pagamentos aumentam simultaneamente.

Pré-requisitos

  • Um limite verificado por endpoint a partir do contrato atual de parceiro AppFolio ou cabeçalhos de resposta; não confie em um valor genérico de taxa para gravações de inquilinos.
  • Cursors de lote persistidos, chaves de idempotência para cada gravação e uma política operacional para pausar cargas de trabalho sensíveis à segurança, como as de final de mês.
  • Um fixture de staging e um proprietário de orçamento de requisições que possa provar tentativas, comportamento de 429 e tratamento de gravações desconhecidas sem tocar em inquilinos de produção.

Instruções

  1. Selecione o teto do limitador para o endpoint específico e mantenha a concorrência abaixo do menor limite aplicável de portfólio ou parceiro.
  2. Adquira um token antes de cada requisição, respeite o Retry-After e limite tentativas com jitter para falhas transitórias do provedor.
  3. Processe gravações a partir de um cursor persistido com chaves de idempotência; nunca repita uma criação de inquilino só porque a resposta foi perdida.
  4. Pause e escale lotes que esgotem o orçamento de tentativas, atinjam uma janela de manutenção ou tenham um resultado de gravação desconhecido.

Referência de Limite de Taxa

EndpointLimiteJanelaEscopo
Lista/obter propriedades120 req1 minutoPor chave de parceiro
Criar/atualizar inquilino30 req1 minutoPor chave de parceiro
Ordens de serviço60 req1 minutoPor chave de parceiro
Exportação de dados em massa5 req1 horaPor chave de parceiro
Registro de webhooks10 req1 minutoPor chave de parceiro

Implementação do Limitador de Taxa

class AppFolioRateLimiter {
  private tokens: number;
  private lastRefill: number;
  private readonly maxTokens: number;
  private readonly refillRate: number; // tokens por 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;
      }
      // Aguarda até que o próximo token esteja disponível; nenhuma requisição posterior é necessária para
      // acordar este chamador.
      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); // configurar por contrato de endpoint

Estratégia de Tentativas

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("Máximo de tentativas excedido");
}

Processamento em Lote

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;
}

Tratamento de Erros

ProblemaCausaCorreção
429 Muitas RequisiçõesLimite de taxa do parceiro excedidoBackoff usando cabeçalho Retry-After
403 na exportação em massaCota horária de exportação atingidaEnfileirar exportações com espaçamento de 15 min
Timeout na lista de propriedadesPortfólio grande (500+ unidades)Paginar com per_page=50
409 Conflito na atualização de inquilinoGravação simultânea no mesmo inquilinoTentar novamente com ETag nova
503 durante manutençãoJanela noturna agendada (2-4 AM PT)Pular requisições, tentar novamente após a janela

Saída

  • Um limitador auto-agendável e específico por endpoint que não pode deixar trabalho enfileirado preso
  • Resultados de tentativas limitados com evidência de Retry-After e dados de falha editados
  • Uma decisão de lote persistida: concluído, pausado para tentativa futura, ou colocado em quarentena para reconciliação pelo operador

Exemplos

Para um lote de atualização de inquilinos no sandbox, configure o limitador abaixo do teto documentado de gravação de inquilinos, processe um registro por vez com chaves de idempotência e preserve o cursor após cada resultado confirmado. Induza um 429 para provar que os chamadores esperam e retomam sem uma requisição adicional, depois induza uma resposta perdida para provar que o registro é colocado em quarentena, e não repetido cegamente. Se os cabeçalhos de taxa entrarem em conflito com o teto configurado, as tentativas se esgotarem ou a manutenção começar, pause o lote e entregue o cursor ao proprietário.

Recursos

Próximos Passos

Consulte 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".

Habilidades Relacionadas