Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

通过 REST API 查询 AppFolio 中的房产、单元和租户信息。

tons-of-skills-marketplace 是什么?

该技能提供了一个安全、受控的方式来通过 AppFolio Property Manager API 读取房产和租户数据。它引导开发者使用提供商颁发的客户端配置,执行只读查询,如列出房产和获取租户数量。该技能明确禁止创建或更新操作,防止意外修改生产数据。它支持 Node.js 18+ 和 TypeScript,并包含详细的错误处理指南(如 401、403、404 等常见错误)。该技能适用于开发者快速验证 API 集成,但强调在确认安全环境和清单权限之前,不得进行写入操作。

兼容平台✓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 Hello World

概述

通过提供商颁发的已验证客户端配置,开始使用 AppFolio Property Manager API。本技能指导完成房产列表和租户数量的安全首次读取;创建或更新操作仅限在单独批准的合成沙盒工作流中进行。

前提条件

  • 具有 API 访问权限的 AppFolio Stack Partner 账户
  • 一个由提供商管理的、已确认目标投资组合的基础 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 Unauthorized无效的 client_id 或密钥验证环境变量中的凭据
403 ForbiddenAPI 作用域未授权检查 Stack Partner 对该端点的权限
404 Not Found错误的基础 URL 或端点确认您的公司子域名和 API 版本
422 Unprocessable缺少必填字段验证 property_id 和必需的请求体参数
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".

相关技能