Communitygithub.com

제레미롱쇼어/다양한-스킬-마켓플레이스

AppFolio REST API를 통해 부동산, 유닛, 세입자 정보를 조회합니다.

다양한-스킬-마켓플레이스란 무엇인가요?

이 스킬은 AppFolio Property Manager API와의 안전한 첫 상호작용을 안내합니다. 공급업체가 발급한 검증된 클라이언트 구성을 사용하여 승인된 부동산 목록과 세입자 수를 읽기 전용으로 조회하는 방법을 보여줍니다. 쓰기 작업은 별도의 승인된 합성 샌드박스 워크플로에서만 수행되어야 하므로, 이 스킬은 실제 프로덕션 환경에서 실수로 데이터를 변경하는 위험을 방지합니다. Node.js 18+ 및 TypeScript 환경에서 사용할 수 있으며, API 호출을 위한 간단한 fetch 함수와 기본적인 오류 처리 패턴을 제공합니다.

지원 대상✓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에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

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(`Found ${properties.length} properties`);
properties.forEach((p: any) => console.log(`  property ID: ${p.id}`));

3단계: 세입자 세부 정보 가져오기

const tenants = await appfolioFetch(`/tenants?property_id=${properties[0].id}`);
console.log(`Retrieved ${tenants.length} tenant records for the approved fixture`);

4단계: 쓰기 전에 중지

// 퀵스타트 테스트로 작업 주문을 생성하지 마십시오. appfolio-core-workflow-b의
// 합성, 멱등성 워크플로로만 계속 진행하십시오.

출력

성공적인 실행은 관리 클라이언트와 승인된 안전 읽기 엔드포인트가 작동함을 입증하며, 로컬 출력에 부동산 ID와 세입자 레코드 수만 반환합니다.

예시

첫 번째 통합 확인을 위해 검증된 샌드박스 클라이언트를 구성하고, 승인된 합성 부동산 페이지 하나를 쿼리한 후 주소, 이름, 유닛 번호 또는 자격 증명을 기록하지 않고 상태, 부동산 ID 및 세입자 수를 확인합니다. 단순히 액세스를 테스트하기 위해 작업 주문을 생성하지 마십시오. 포트폴리오 계약, 안전 읽기 픽스처 또는 응답 권한 부여가 확인되지 않은 경우 실행을 중지하고, 변형을 시도하기 전에 자격 증명 소유자의 스테이징 프로세스를 사용하십시오.

오류 처리

오류원인해결 방법
401 Unauthorized잘못된 client_id 또는 secret환경 변수에서 자격 증명 확인
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".

관련 스킬