Communitygithub.com

AppFolio Limites de Taux

Gérer les limites de taux de l'API AppFolio avec throttling et backoff.

Qu'est-ce que AppFolio Limites de Taux ?

Cette compétence fournit une solution robuste pour gérer les limites de taux de l'API Stack d'AppFolio, garantissant une utilisation fiable des points de terminaison API critiques tels que les importations de locataires en masse, les synchronisations de registres de loyers et les mises à jour par lots des ordres de travail. Elle implémente un limiteur de taux configurable avec un algorithme de seau à jetons, une stratégie de tentatives avec backoff exponentiel et jitter, et un traitement par lots avec idempotence. La compétence prend en charge les plateformes conçues pour les agents d'IA et les développeurs travaillant avec l'API AppFolio, et est optimisée pour les environnements à fort volume comme les propriétaires de portefeuilles effectuant des synchronisations nocturnes. Elle inclut un tableau de référence des limites de taux pour différents points de terminaison et une gestion des erreurs complète avec des options de mise en pause et de quarantaine. L'architecture garantit qu'aucun travail en file d'attente n'est bloqué et que les décisions de lots sont persistées pour la réconciliation de l'opérateur.

Compatible avec✓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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait AppFolio Limites de Taux ?

Aperçu

L'API Stack d'AppFolio applique des limites de taux par partenaire pour protéger l'infrastructure de gestion immobilière partagée. Les opérations à fort volume telles que les importations de locataires en masse, les synchronisations de registres de loyers et les mises à jour par lots des ordres de travail peuvent rapidement épuiser les quotas. Les propriétaires de portefeuilles effectuant des synchronisations nocturnes de portefeuille sur des centaines d'unités doivent limiter soigneusement, surtout en fin de mois lorsque les renouvellements de baux et le traitement des paiements augmentent simultanément.

Prérequis

  • Une limite par point de terminaison vérifiée à partir du contrat partenaire AppFolio actuel ou des en-têtes de réponse ; ne pas se fier à une valeur de taux générique pour les écritures de locataires.
  • Des curseurs de lots persistés, des clés d'idempotence pour chaque écriture, et une politique d'opérateur pour suspendre les charges de travail de fin de mois ou autres sensibles à la sécurité.
  • Un environnement de test (staging) et un propriétaire de budget de requêtes qui peut prouver les tentatives, le comportement 429 et la gestion des écritures inconnues sans toucher aux locataires de production.

Instructions

  1. Sélectionnez le plafond du limiteur pour le point de terminaison spécifique et maintenez la concurrence en dessous de la plus petite limite applicable du portefeuille ou du partenaire.
  2. Acquérez un jeton avant chaque requête, respectez Retry-After, et plafonnez les tentatives avec jitter pour les défaillances transitoires du fournisseur.
  3. Traitez les écritures à partir d'un curseur persisté avec des clés d'idempotence ; ne rejouez jamais une création de locataire simplement parce que la réponse a été perdue.
  4. Suspendre et escalader les lots qui épuisent le budget de tentatives, rencontrent une fenêtre de maintenance, ou ont un résultat d'écriture inconnu.

Référence des Limites de Taux

Point de terminaisonLimiteFenêtrePortée
Liste/obtenir propriétés120 req1 minutePar clé partenaire
Créer/mettre à jour locataire30 req1 minutePar clé partenaire
Ordres de travail60 req1 minutePar clé partenaire
Exportation de données en masse5 req1 heurePar clé partenaire
Enregistrement de webhooks10 req1 minutePar clé partenaire

Implémentation du Limiteur de Taux

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;
      }
      // Attend jusqu'à ce que le prochain jeton soit disponible ; aucune requête ultérieure n'est nécessaire pour
      // réveiller cet appelant.
      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); // configurer selon le contrat du point de terminaison

Stratégie de Tentatives

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

Traitement par Lots

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

Gestion des Erreurs

ProblèmeCauseCorrectif
429 Trop de RequêtesLimite de taux du partenaire dépasséeBackoff en utilisant l'en-tête Retry-After
403 sur export en massePlafond d'export horaire atteintMettre en file d'attente les exports avec un espacement de 15 minutes
Timeout sur liste de propriétésGrand portefeuille (500+ unités)Paginer avec per_page=50
409 Conflit sur mise à jour de locataireÉcriture simultanée sur le même locataireRéessayer avec un nouvel ETag
503 pendant maintenanceFenêtre nocturne planifiée (2-4 AM PT)Ignorer les requêtes, réessayer après la fenêtre

Résultats

  • Un limiteur auto-planifié, spécifique au point de terminaison, qui ne peut pas bloquer le travail en file d'attente
  • Des résultats de tentatives bornés avec preuve de Retry-After et données d'échec expurgées
  • Une décision de lot persistée : terminée, mise en pause pour une tentative ultérieure, ou mise en quarantaine pour la réconciliation de l'opérateur

Exemples

Pour un lot de mise à jour de locataire en environnement de test, configurez le limiteur en dessous du plafond documenté d'écriture de locataire, traitez un enregistrement à la fois avec des clés d'idempotence, et préservez le curseur après chaque résultat confirmé. Provoquez une 429 pour prouver que les appelants attendent et reprennent sans requête supplémentaire, puis provoquez une réponse perdue pour prouver que l'enregistrement est mis en quarantaine plutôt que rejoué aveuglément. Si les en-têtes de taux entrent en conflit avec le plafond configuré, si les tentatives s'épuisent ou si la maintenance commence, mettez le lot en pause et remettez le curseur au propriétaire.

Ressources

Prochaines Étapes

Voir 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 associés