Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

Construire un tableau de bord de gestion immobilière avec les données de l'API AppFolio.

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

Cette compétence automatise le workflow principal de l'intégration de gestion immobilière AppFolio, couvrant l'ensemble du cycle de vie d'une propriété : création et mise à jour des fiches, gestion des profils locataires et des baux, et interrogation des données d'occupation. Elle utilise l'API Stack d'AppFolio avec OAuth 2.0 (client credentials) pour un accès sécurisé de serveur à serveur, toutes les réponses étant en JSON avec pagination via paramètre `cursor`. Destinée aux agents AI comme Claude Code, Cursor ou Codex, elle nécessite un contrat API actif, un bac à sable de test, des clés d'idempotence et un processus de rollback validé. Les instructions détaillent l'authentification, la création de propriétés, l'ajout de locataires et la création de baux, avec une gestion d'erreurs complète (codes 401, 404, 422, 409, 429) et un exemple de rollback sécurisé.

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-core-workflow-a

Demander à votre IA préférée

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

Documentation

AppFolio — Gestion des propriétés et des locataires

Présentation

Workflow principal pour l'intégration de la gestion immobilière AppFolio. Couvre l'ensemble du cycle de vie d'une propriété : création et mise à jour des fiches, gestion des profils locataires et des contrats de location, et interrogation des données d'occupation. Utilise l'API Stack d'AppFolio avec OAuth 2.0 (client credentials) pour un accès de serveur à serveur. Tous les endpoints renvoient du JSON et prennent en charge la pagination via le paramètre cursor pour les grands portefeuilles.

Prérequis

  • Un contrat partenaire/API AppFolio en cours qui confirme l'URL de base du portefeuille attribué, la méthode d'authentification, les portées approuvées et les capacités d'écriture ; ne pas les déduire d'un tutoriel ou d'un autre portefeuille.
  • Un bac à sable séparé avec des propriétés, unités et enregistrements de locataires synthétiques, ainsi qu'un propriétaire d'identifiants et un budget de requêtes approuvé.
  • Des clés d'idempotence et un processus de rollback/réconciliation approuvé par l'opérateur pour les écritures sur les propriétés, locataires et baux, qui peuvent avoir des conséquences juridiques et de facturation réelles.

Instructions

  1. Confirmer l'URL de base et le flux d'authentification fournis par le prestataire pour le portefeuille cible avant de copier une configuration client dans un environnement.
  2. N'utiliser le chemin de création/mise à jour qu'avec des fixtures synthétiques du bac à sable et des clés d'idempotence ; récupérer les enregistrements canoniques avant de réessayer une écriture incertaine.
  3. Valider la propriété, les dates de bail et la disponibilité des unités avant de créer un bail, et n'émettre que les identifiants d'enregistrement et les preuves de statut expurgées.
  4. Ne promouvoir un flux capable d'écriture qu'après une répétition en conditions réelles prouvant le rollback, la réconciliation et la limite de portée la moins privilégiée.

Étape 1 : Authentification et initialisation du client

const token = await fetch('https://api.appfolio.com/oauth/token', {
  method: 'POST',
  headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
  body: new URLSearchParams({
    grant_type: 'client_credentials',
    client_id: process.env.APPFOLIO_CLIENT_ID!,
    client_secret: process.env.APPFOLIO_CLIENT_SECRET!,
    scope: 'properties tenants leases',
  }),
}).then(r => r.json());
const headers = { Authorization: `Bearer ${token.access_token}`, 'Content-Type': 'application/json' };

Étape 2 : Créer ou mettre à jour une propriété

const property = await fetch('https://api.appfolio.com/v1/properties', {
  method: 'POST', headers,
  body: JSON.stringify({
    name: 'Sunrise Apartments',
    address: { street: '100 Main St', city: 'Austin', state: 'TX', zip: '78701' },
    type: 'residential',
    units: [
      { number: '101', bedrooms: 2, bathrooms: 1, rent: 1450 },
      { number: '102', bedrooms: 1, bathrooms: 1, rent: 1100 },
    ],
  }),
}).then(r => r.json());
console.log(`Propriété créée : ${property.id}`);

Étape 3 : Ajouter un locataire et un bail

const tenant = await fetch('https://api.appfolio.com/v1/tenants', {
  method: 'POST', headers,
  body: JSON.stringify({
    first_name: 'Test', last_name: 'Tenant',
    email: '[email protected]', phone: '555-0100',
  }),
}).then(r => r.json());

await fetch('https://api.appfolio.com/v1/leases', {
  method: 'POST', headers,
  body: JSON.stringify({
    property_id: property.id, unit_number: '101',
    tenant_id: tenant.id, start_date: '2026-05-01', end_date: '2027-04-30',
    monthly_rent: 1450, security_deposit: 1450,
  }),
}).then(r => r.json());

Étape 4 : Interroger l'occupation

const units = await fetch(
  `https://api.appfolio.com/v1/properties/${property.id}/units?status=vacant`,
  { headers },
).then(r => r.json());
console.log(`Unités vacantes : ${units.data.length} sur ${units.meta.total}`);

Gestion des erreurs

ProblèmeCauseCorrectif
401 UnauthorizedJeton expiré ou invalideRéauthentifier avec les identifiants client
404 Not FoundMauvais ID de propriété/locataireVérifier que l'ID existe avant de l'utiliser
422 UnprocessableChamps obligatoires manquantsVérifier le tableau errors[] dans le corps de la réponse
409 ConflictBail en double pour l'unitéInterroger les baux existants avant de créer
429 Too Many RequestsLimite de débit dépasséeAttendre en utilisant l'en-tête Retry-After

Résultat

Une exécution réussie crée une propriété avec des unités, ajoute un locataire, les lie via un bail, et rapporte le nombre de vacances. La sortie console confirme chaque ID de ressource à la création.

Exemples

Pour une modification de bail, exécuter contre une unité de bac à sable synthétique nommée et un locataire avec une clé d'idempotence stable. Lire la propriété et les baux actuels, effectuer l'écriture candidate une fois, puis relire le bail résultant et n'enregistrer que les ID, les dates et le statut de réconciliation. Réexécuter la même requête pour prouver qu'elle ne crée pas un second bail. Si le contrat fournisseur, l'endpoint, l'autorisation ou le résultat d'une écriture antérieure ne peut pas être vérifié, arrêter avant toute écriture et transmettre le cas à l'opérateur du portefeuille pour réconciliation.

Ressources

Prochaines étapes

Continuer avec appfolio-core-workflow-b pour les demandes d'entretien et le suivi des paiements.

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

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

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