Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

Behandelt AppFolio-API-Ratenbegrenzungen mit Drosselung und Backoff.

Was ist tons-of-skills-marketplace?

Diese Fähigkeit (Skill) implementiert eine robuste Strategie zur Bewältigung von API-Ratenlimits in der AppFolio Stack-API. Sie ist besonders nützlich für Property Manager, die große Datenmengen wie Mietersynchronisationen oder Arbeitsaufträge verarbeiten und dabei die von AppFolio vorgegebenen Limits pro Partner einhalten müssen. Der Skill bietet eine Token-Bucket-basierte Ratenbegrenzung, eine exponentielle Backoff-Strategie mit Jitter sowie eine Batch-Verarbeitung mit Cursor-Management. Er unterstützt die Identifizierung und Behandlung von HTTP-Statuscodes wie 429 (Too Many Requests) und 503 (Service Unavailable) mithilfe des `Retry-After`-Headers. Entwickler können den Skill auf verschiedenen Plattformen wie Claude Code, Cursor oder Codex nutzen, um sichere, wiederholbare API-Aufrufe zu gewährleisten und Datenkonsistenz zu erhalten.

Funktioniert mit✓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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

AppFolio-Ratenlimits

Übersicht

Die AppFolio Stack-API setzt partnerabhängige Ratenlimits durch, um die gemeinsam genutzte Infrastruktur für die Immobilienverwaltung zu schützen. Hochvolumige Vorgänge wie Massen-Mieterimporte, Mietspiegel-Synchronisationen und Batch-Updates von Arbeitsaufträgen können die Kontingente schnell erschöpfen. Property Manager, die nächtliche Portfolio-Synchronisationen über Hunderte von Einheiten hinweg durchführen, müssen die Drosselung sorgfältig justieren, insbesondere am Monatsende, wenn Mietverlängerungen und Zahlungsabwicklungen gleichzeitig ansteigen.

Voraussetzungen

  • Ein verifiziertes, endpointspezifisches Limit aus dem aktuellen AppFolio-Partnervertrag oder den Antwortheadern; verlassen Sie sich nicht auf einen generischen Ratenwert für Mieter-Schreibvorgänge.
  • Persistierte Batch-Cursor, Idempotenzschlüssel für jeden Schreibvorgang und eine Betriebsrichtlinie für das Anhalten von workloads, die sicherheitskritisch sind (z. B. am Monatsende).
  • Eine Testumgebung und ein Request-Budget-Verantwortlicher, die nachweisen können, dass Wiederholungen, 429-Verhalten und unbekannte Schreibvorgänge ohne Beeinträchtigung von Produktionsmandanten behandelt werden.

Anleitung

  1. Wählen Sie die Begrenzungsgrenze für den jeweiligen Endpunkt und halten Sie die Parallelität unter dem kleinsten anwendbaren Portfolio- oder Partnerlimit.
  2. Holen Sie vor jeder Anfrage ein Token ein, beachten Sie Retry-After, und begrenzen Sie Wiederholungen mit Jitter bei vorübergehenden Provider-Fehlern.
  3. Verarbeiten Sie Schreibvorgänge von einem persistierten Cursor aus mit Idempotenzschlüsseln; wiederholen Sie niemals eine Mietererstellung nur, weil die Antwort verloren ging.
  4. Stoppen Sie Batches, die das Wiederholungsbudget erschöpfen, in ein Wartungsfenster fallen oder ein unbekanntes Schreibergebnis haben, und eskalieren Sie sie.

Referenz zu Ratenlimits

EndpunktLimitFensterGeltungsbereich
Eigenschaften auflisten/abrufen120 Anfragen1 MinutePro Partner-Schlüssel
Mieter erstellen/aktualisieren30 Anfragen1 MinutePro Partner-Schlüssel
Arbeitsaufträge60 Anfragen1 MinutePro Partner-Schlüssel
Massendatenexport5 Anfragen1 StundePro Partner-Schlüssel
Webhook-Registrierung10 Anfragen1 MinutePro Partner-Schlüssel

Implementierung des Ratenbegrenzers

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;
      }
      // Warten, bis das nächste Token verfügbar ist; es ist keine spätere Anfrage
      // erforderlich, um diesen Aufrufer aufzuwecken.
      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); // gemäß Endpunktvertrag konfigurieren

Wiederholungsstrategie

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("Maximale Anzahl von Wiederholungen überschritten");
}

Batch-Verarbeitung

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

Fehlerbehandlung

ProblemUrsacheLösung
429 Too Many RequestsPartner-Ratenlimit überschrittenBackoff mithilfe des Retry-After-Headers
403 bei Bulk-ExportStündliches Exportlimit erreichtExporte im 15-Minuten-Abstand in die Warteschlange einreihen
Timeout bei EigenschaftslisteGroßes Portfolio (500+ Einheiten)Paginierung mit per_page=50
409 Conflict bei MieteraktualisierungGleichzeitiger Schreibvorgang auf denselben MieterWiederholung mit aktuellem ETag
503 während WartungsarbeitenGeplantes nächtliches Wartungsfenster (2-4 Uhr PT)Anfragen auslassen, nach dem Fenster wiederholen

Ausgabe

  • Ein selbstplanender, endpointspezifischer Begrenzer, der eingeplante Arbeiten nicht blockieren kann
  • Begrenzte Wiederholungsergebnisse mit Retry-After-Nachweis und geschwärzten Fehlerdaten
  • Eine persistierte Batch-Entscheidung: abgeschlossen, zur späteren Wiederholung angehalten oder für die Operator-Abstimmung unter Quarantäne gestellt

Beispiele

Stellen Sie für einen Sandbox-Mieteraktualisierungs-Batch den Begrenzer unter dem dokumentierten Mieter-Schreib-Limit ein, verarbeiten Sie einen Datensatz nach dem anderen mit Idempotenzschlüsseln und bewahren Sie den Cursor nach jedem bestätigten Ergebnis auf. Lösen Sie einen 429-Fehler aus, um nachzuweisen, dass Aufrufer warten und ohne zusätzliche Anfrage fortfahren. Lösen Sie dann eine verlorene Antwort aus, um zu beweisen, dass der Datensatz unter Quarantäne gestellt wird und nicht blind wiederholt wird. Wenn die Raten-Header mit dem konfigurierten Limit kollidieren, Wiederholungen ausgeschöpft werden oder Wartungsarbeiten beginnen, stoppen Sie den Batch und übergeben Sie den Cursor an den Verantwortlichen.

Ressourcen

Nächste Schritte

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

Verwandte Skills