Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

Konfigurieren Sie die AppFolio Stack API-Authentifizierung mit HTTP Basic Auth.

Was ist tons-of-skills-marketplace?

Diese Fähigkeit ermöglicht Entwicklern die Authentifizierung bei der AppFolio Stack API über HTTP Basic Auth mit Client-ID und Client-Secret, die über das AppFolio Stack Partnerprogramm bereitgestellt werden. Sie eignet sich für die Einrichtung von Property-Management-API-Zugriffen, die Registrierung als AppFolio Stack Partner oder die Konfiguration von Client-Anmeldeinformationen. Die Fähigkeit unterstützt Node.js und Python und bietet eine TypeScript-Client-Implementierung sowie eine Anleitung zur sicheren Handhabung von Geheimnissen. Sie umfasst Schritte zum Abrufen von API-Anmeldedaten, Erstellen eines API-Clients und Überprüfen der Verbindung ohne Offenlegung von Anmeldedaten in Befehlszeilenargumenten. Zusätzlich werden API-Endpunkte, Fehlerbehandlung und bewährte Verfahren für die erste Authentifizierung beschrieben.

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-install-auth

In Ihrer bevorzugten KI fragen

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

Dokumentation

AppFolio Installieren & Authentifizieren

Überblick

Konfigurieren Sie die AppFolio Stack API-Authentifizierung. AppFolio verwendet HTTP Basic Auth mit einer Client-ID und einem Client-Secret, die über das Stack Partnerprogramm bereitgestellt werden. Es gibt kein öffentliches npm SDK – verwenden Sie direkte REST-API-Aufrufe.

Voraussetzungen

  • AppFolio Stack Partnerkonto (appfolio.com/stack)
  • Client-ID und Client-Secret von AppFolio
  • Node.js 18+ oder Python 3.10+

Anleitung

Schritt 1: API-Anmeldedaten abrufen

# AppFolio Stack API-Anmeldedaten stammen aus dem Partnerprogramm
# 1. Bewerben Sie sich unter appfolio.com/stack/become-a-partner
# 2. Schließen Sie die Integrationsprüfung ab
# 3. Erhalten Sie die vom Anbieter ausgegebene Basis-URL und Anweisungen zur Übermittlung der Anmeldedaten.
# Speichern Sie die Werte im genehmigten Secret Manager. Committen Sie nur diese nicht-geheime
# Vorlage, wenn die lokale Entwicklung eine erfordert:
cat > .env.example << 'ENVFILE'
APPFOLIO_CLIENT_ID=
APPFOLIO_CLIENT_SECRET=
APPFOLIO_BASE_URL=
ENVFILE

# .env bleibt ignoriert; befüllen Sie es nur über einen genehmigten lokalen Secret-Flow.

Schritt 2: API-Client erstellen

// src/appfolio-client.ts
import axios, { AxiosInstance } from 'axios';

class AppFolioClient {
  private api: AxiosInstance;

  constructor() {
    this.api = axios.create({
      baseURL: process.env.APPFOLIO_BASE_URL,
      auth: {
        username: process.env.APPFOLIO_CLIENT_ID!,
        password: process.env.APPFOLIO_CLIENT_SECRET!,
      },
      headers: { 'Content-Type': 'application/json' },
      timeout: 30000,
    });
  }

  async verifyConnection(): Promise<boolean> {
    try {
      const response = await this.api.get('/properties');
      console.log(`Verbindung hergestellt! ${response.data.length} Immobilien gefunden`);
      return true;
    } catch (error: any) {
      console.error(`Verbindung fehlgeschlagen: ${error.response?.status} ${error.message}`);
      return false;
    }
  }

  get http(): AxiosInstance { return this.api; }
}

export { AppFolioClient };

Schritt 3: Verbindung prüfen

# Kurze, bereinigte Diagnose ohne Basic Auth in argv zu setzen.
NETRC_FILE="$(mktemp)"
trap 'rm -f "$NETRC_FILE"' EXIT
chmod 600 "$NETRC_FILE"
APPFOLIO_HOST="${APPFOLIO_BASE_URL#https://}"
APPFOLIO_HOST="${APPFOLIO_HOST%%/*}"
printf 'machine %s login %s password %s\n' "$APPFOLIO_HOST" \
  "$APPFOLIO_CLIENT_ID" "$APPFOLIO_CLIENT_SECRET" > "$NETRC_FILE"
curl -s -o /dev/null -w '%{http_code}\n' --netrc-file "$NETRC_FILE" \
  "${APPFOLIO_BASE_URL}/properties"

API-Endpunkte

RessourceEndpunktMethoden
Immobilien/api/v1/propertiesGET
Einheiten/api/v1/unitsGET
Mieter/api/v1/tenantsGET
Mietverträge/api/v1/leasesGET, POST
Rechnungen/api/v1/billsGET, POST
Anbieter/api/v1/vendorsGET
Eigentümer/api/v1/ownersGET
Berichte/api/v1/reportsGET

Ausgabe

  • Vom Anbieter ausgegebene Anmeldedaten, die über die genehmigte Secret-Grenze injiziert werden
  • TypeScript REST-Client mit Basic Auth
  • Bereinigtes Konnektivitätsergebnis für den genehmigten Safe-Read-Endpunkt

Beispiele

Für eine erste Authentifizierungsprobe injizieren Sie eine Sandbox-Anmeldedaten und die vom Anbieter ausgegebene Basis-URL über den lokalen Secret-Mechanismus und führen Sie dann eine schreibgeschützte Anfrage an eine genehmigte synthetische Immobilienseite aus. Zeichnen Sie nur den Statuscode und das Client-Konfigurationsurteil auf; geben Sie keine Immobilien-Payload, Client-ID, Secret oder vollständigen Host/Pfad in gemeinsamen Logs aus. Wenn der Vertrag, die Basis-URL, die Secret-Bindung oder das Statusergebnis nicht verifiziert sind, halten Sie vor jedem Schreibworkflow an und lassen Sie den Anmeldedaten-Besitzer die Konfiguration korrigieren.

Fehlerbehandlung

FehlerUrsacheLösung
401 UnauthorizedUngültige AnmeldedatenÜberprüfen Sie client_id/secret von AppFolio
403 ForbiddenKein Stack-PartnerSchließen Sie den Partnerantrag ab
404 Not FoundFalsche Basis-URLVerwenden Sie das Format your-company.appfolio.com
ZeitüberschreitungNetzwerkproblemPrüfen Sie, ob die Firewall HTTPS zu appfolio.com erlaubt

Ressourcen

Nächste Schritte

Fahren Sie mit appfolio-hello-world für Ihre erste Immobilienabfrage fort.

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

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

jeremylongshore/tons-of-skills-marketplace

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

Verwandte Skills