Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

Configurez l'authentification de l'API AppFolio Stack avec OAuth 2.0. Utilisez-le pour configurer l'accès à l'API de gestion immobilière, vous inscrire en tant que partenaire AppFolio Stack ou configurer les identifiants client pour les appels API. Déclencheur : "install appfolio", "setup appfolio", "appfolio auth", "appfolio API key".

Qu'est-ce que tons-of-skills-marketplace ?

Cette compétence fournit une configuration complète pour l'authentification de l'API AppFolio Stack, utilisant l'authentification Basic HTTP avec un ID client et un secret client obtenus via le programme partenaire AppFolio Stack. Elle est conçue pour les développeurs qui ont besoin d'intégrer des API de gestion immobilière, comme celles pour les propriétés, unités, locataires, baux, factures, fournisseurs, propriétaires et rapports, dans leurs applications. La compétence guide l'utilisateur à travers l'obtention des identifiants API, la création d'un client TypeScript avec gestion des erreurs et la vérification de la connexion de manière sécurisée sans exposer les secrets. Elle prend en charge Node.js 18+ et Python 3.10+ et propose des exemples pour un test en bac à sable et une validation de configuration avant de passer aux workflows d'écriture.

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

Demander à votre IA préférée

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

Documentation

Installation et authentification AppFolio

Aperçu

Configurez l'authentification de l'API AppFolio Stack. AppFolio utilise l'authentification Basic HTTP avec un ID client et un secret client, fournis via leur programme partenaire Stack. Aucun SDK npm public n'existe — utilisez des appels REST API directs.

Prérequis

  • Compte partenaire AppFolio Stack (appfolio.com/stack)
  • ID client et secret client d'AppFolio
  • Node.js 18+ ou Python 3.10+

Instructions

Étape 1 : Obtenir les identifiants API

# Les identifiants de l'API AppFolio Stack proviennent du programme partenaire
# 1. Postulez sur appfolio.com/stack/devenir-partenaire
# 2. Terminez la revue d'intégration
# 3. Recevez l'URL de base fournie par le prestataire et les instructions de livraison des identifiants.
# Stockez les valeurs dans le gestionnaire de secrets approuvé. Ne committez que ce modèle non secret
# si le développement local en nécessite un :
cat > .env.example << 'ENVFILE'
APPFOLIO_CLIENT_ID=
APPFOLIO_CLIENT_SECRET=
APPFOLIO_BASE_URL=
ENVFILE

# .env reste ignoré ; ne le remplissez que via un flux de secret local approuvé.

Étape 2 : Créer le client API

// 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(`Connecté ! ${response.data.length} propriétés trouvées`);
      return true;
    } catch (error: any) {
      console.error(`Connexion échouée : ${error.response?.status} ${error.message}`);
      return false;
    }
  }

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

export { AppFolioClient };

Étape 3 : Vérifier la connexion

# Diagnostic rapide et expurgé sans mettre Basic Auth dans argv.
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"

Points d'accès API

RessourcePoint d'accèsMéthodes
Propriétés/api/v1/propertiesGET
Unités/api/v1/unitsGET
Locataires/api/v1/tenantsGET
Baux/api/v1/leasesGET, POST
Factures/api/v1/billsGET, POST
Fournisseurs/api/v1/vendorsGET
Propriétaires/api/v1/ownersGET
Rapports/api/v1/reportsGET

Résultat

  • Identifiants fournis par le prestataire injectés via la frontière de secret approuvée
  • Client REST TypeScript avec Basic Auth
  • Résultat de connectivité expurgé pour le point d'accès en lecture seule approuvé

Exemples

Pour une première répétition d'authentification, injectez un identifiant de bac à sable et l'URL de base fournie par le prestataire via le mécanisme de secret local, puis effectuez une seule requête en lecture seule vers une page de propriété synthétique approuvée. Enregistrez uniquement le code de statut et le verdict de configuration du client ; n'imprimez pas la charge utile de la propriété, l'ID client, le secret ou le chemin d'hôte complet dans les journaux partagés. Si le contrat, l'URL de base, la liaison du secret ou le résultat de statut n'est pas vérifié, arrêtez-vous avant tout workflow d'écriture et demandez au propriétaire de l'identifiant de corriger la configuration.

Gestion des erreurs

ErreurCauseSolution
401 Non autoriséIdentifiants invalidesVérifiez client_id/secret auprès d'AppFolio
403 InterditPas un partenaire StackTerminez la demande de partenaire
404 Non trouvéMauvaise URL de baseUtilisez le format votre-entreprise.appfolio.com
Délai d'attenteProblème réseauVérifiez que le pare-feu autorise HTTPS vers appfolio.com

Ressources

Prochaines étapes

Passez à appfolio-hello-world pour votre première requête de propriété.

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

Skills associés