Communitygithub.com

AppFolio 基本操作

透過 REST API 查詢 AppFolio 房產、單位與租客資訊。

AppFolio 基本操作 是什麼?

此技能旨在協助開發者安全地首次讀取 AppFolio Property Manager API 中的房產與租客資料,避免未經授權的建立或修改操作。它使用由提供者驗證的用戶端配置,並僅執行唯讀查詢,例如列出前 10 個房產與對應的租客數量,非常適合進行整合測試。支援的平台為 CLI 工具(如 Claude Code、Cursor),且需要 Node.js 18+ 與 TypeScript 環境。該技能透過一個包裝好的 `appfolioFetch` 函數來發送 GET 請求,並在遇到錯誤時提供清晰的錯誤表與解決方案。重要的是,技能明確提醒不得作為快速測試而建立工單,任何寫入操作應在專門的沙箱工作流程中進行,以確保資料安全。

相容平台✓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-hello-world

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

AppFolio 基本操作 是做什麼的?

概述

透過經過驗證且由服務提供者發放的用戶端設定,開始使用 AppFolio Property Manager API。此技能會引導你安全地進行房產清單與租客人數的首次唯獨讀取;新增或更新操作僅屬於另行核准的合成沙箱工作流程。

先決條件

  • AppFolio Stack 合作夥伴帳戶且已啟用 API 存取
  • 由提供者管理的目標投資組合基本 URL 與通過驗證的用戶端;請勿使用猜測的主機名稱或憑證方案
  • Node.js 18+ 與 TypeScript

操作步驟

步驟 1:設定用戶端

async function appfolioFetch(path: string) {
  const res = await createVerifiedAppFolioClient().get(path);
  if (res.status < 200 || res.status >= 300) throw new Error(`AppFolio ${res.status}`);
  return res.data;
}

步驟 2:列出房產

const properties = await appfolioFetch("/properties?page_size=10");
console.log(`找到 ${properties.length} 筆房產`);
properties.forEach((p: any) => console.log(`  房產 ID: ${p.id}`));

步驟 3:取得租客詳細資料

const tenants = await appfolioFetch(`/tenants?property_id=${properties[0].id}`);
console.log(`已為核准的測試資料擷取 ${tenants.length} 筆租客記錄`);

步驟 4:停止寫入操作之前

// 請勿為了快速入門測試而建立工單。僅繼續使用 appfolio-core-workflow-b 中的合成、冪等工作流程。

輸出結果

成功的執行證明了受管理的用戶端與已核准的唯讀端點能正常運作,並在本地輸出中僅傳回房產 ID 與租客記錄數量。

範例

首次整合檢查時,設定經過驗證的沙箱用戶端,查詢一頁已核准的合成房產,並確認其狀態、房產 ID 與租客人數,且不記錄地址、姓名、單位編號或憑證。請勿為了測試存取權而建立工單。若投資組合合約、唯讀測試資料或回應授權未經確認,請停止執行,並在使用者憑證持有者的暫存環境中完成驗證後,再嘗試任何修改操作。

錯誤處理

錯誤原因解決方案
401 Unauthorizedclient_id 或 secret 無效確認環境變數中的憑證正確
403 ForbiddenAPI 範圍未授予檢查 Stack Partner 對端點的權限
404 Not Found錯誤的基本 URL 或端點確認你的公司子網域與 API 版本
422 Unprocessable缺少必要欄位驗證 property_id 與必要的 body 參數
429 Too Many Requests超出速率限制加入退避延遲,批次處理請求

資源

後續步驟

請參閱 appfolio-core-workflow-a 以取得完整的房產與租客管理工作流程。

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

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

相關技能