Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

使用 AppFolio API 資料建置物業管理儀表板。

tons-of-skills-marketplace 是什麼?

此技能提供完整的 AppFolio 物業管理整合工作流程,涵蓋物業記錄的建立與更新、租戶檔案與租約管理,以及入住率查詢。它使用 AppFolio Stack API 並透過 OAuth 2.0 用戶端憑證進行伺服器對伺服器的安全存取,所有端點皆回傳 JSON 格式資料,並支援透過游標參數分頁處理大型物業組合。此技能支援的觸發詞為「appfolio property dashboard」,可於多種 AI 代理平台(如 Claude Code、Cursor 或 Codex)中使用。實施時需要先確認提供者發行的基礎 URL 與驗證流程,並嚴格遵循沙盒測試、冪等性金鑰與復原程序,以確保寫入操作的安全性。成功執行後會建立物業單元、新增租戶、產生租約,並回報空置單元數量,為開發者提供一個可重複使用的物業管理儀表板建置範例。

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

在你喜歡的 AI 中提問

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

說明文件

AppFolio — 物業與租戶管理

概覽

AppFolio 物業管理整合的主要工作流程。涵蓋完整的物業生命週期:建立與更新物業記錄、管理租戶檔案與租約協議,以及查詢入住率資料。使用 AppFolio Stack API,並透過 OAuth 2.0 用戶端憑證進行伺服器對伺服器的存取。所有端點皆回傳 JSON,並支援透過 cursor 參數分頁處理大型物業組合。

先決條件

  • 一份有效的 AppFolio 合作夥伴/API 合約,其中需確認指派的物業組合基礎 URL、驗證方法、已核准的範圍,以及寫入能力;不得從教學或其他物業組合推斷這些資訊。
  • 一個獨立的沙盒環境,包含可拋棄的物業、單元與合成租戶記錄,以及一個憑證擁有者和已核准的請求預算。
  • 針對物業、租戶與租約寫入操作的冪等性金鑰,以及營運者核准的回滾/復原程序,因為這些操作可能會產生實際的法律與帳務後果。

指示

  1. 在將任何用戶端設定複製到環境之前,先確認提供者針對目標物業組合發行的基礎 URL 與驗證流程。
  2. 僅在沙盒中使用合成測試資料與冪等性金鑰來執行建立/更新路徑;在不確定的寫入操作重試前,先取得正規記錄。
  3. 在建立租約之前,驗證所有權、租約日期與單元可用性,並僅輸出記錄 ID 與經過編輯的狀態證據。
  4. 只有在階段性排練證明回滾、復原以及最低權限範圍邊界可行之後,才推廣具寫入能力的流程。

步驟 1:驗證並初始化客戶端

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

步驟 2:建立或更新物業

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(`Property created: ${property.id}`);

步驟 3:新增租戶與租約

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());

步驟 4:查詢入住率

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

錯誤處理

問題原因解決方案
401 Unauthorized憑證過期或無效使用用戶端憑證重新驗證
404 Not Found錯誤的物業/租戶 ID在引用前確認資源 ID 存在
422 Unprocessable缺少必要欄位檢查回應主體中的 errors[] 陣列
409 Conflict單元已有重複租約在建立前查詢現有租約
429 Too Many Requests超過速率限制根據 Retry-After 標頭值退避重試

輸出

成功執行後會建立包含單元的物業、新增租戶、透過租約將兩者綁定,並回報空置單元數量。主控台會在建立時輸出每個資源 ID。

範例

對於租約建立變更,請針對指定的命名合成沙盒單元與租戶,使用穩定的冪等性金鑰執行。先讀取物業與當前租約,執行一次候選寫入,然後回讀產生的租約,僅記錄 ID、日期與復原狀態。重複執行相同請求以證明不會建立第二份租約。如果無法驗證提供者合約、端點、授權或先前寫入結果,請在寫入前停止,並將案件轉交給物業組合營運者進行復原。

資源

下一步

繼續使用 appfolio-core-workflow-b 進行維護請求與付款追蹤。

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

相關技能