Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

AppFolio Stack API 인증을 OAuth 2.0으로 구성합니다. 부동산 관리 API 접근 설정, AppFolio Stack 파트너 등록 또는 API 호출을 위한 클라이언트 자격 증명 구성 시 사용합니다.

tons-of-skills-marketplace란 무엇인가요?

이 스킬은 AppFolio Stack API에 대한 인증을 설정하는 방법을 제공합니다. AppFolio는 HTTP Basic Auth를 사용하며, 클라이언트 ID와 시크릿을 Stack 파트너 프로그램을 통해 발급받습니다. 공식 npm SDK는 없으므로 직접 REST API 호출을 사용해야 합니다. Node.js 18+ 또는 Python 3.10+ 환경에서 사용할 수 있으며, 파트너 계정과 인증 정보가 사전에 준비되어 있어야 합니다. 이 스킬은 TypeScript 기반의 API 클라이언트 생성, 연결 확인, 주요 엔드포인트(Properties, Units, Tenants 등) 호출 방법을 안내합니다. 또한 오류 처리 표, curl을 통한 안전한 연결 진단 방법, 그리고 인증 실패 시 대처 방안을 포함합니다.

지원 대상✓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-install-auth

즐겨 사용하는 AI에게 물어보기

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

문서

AppFolio 설치 및 인증

개요

AppFolio Stack API 인증을 구성합니다. AppFolio는 클라이언트 ID와 클라이언트 시크릿을 사용하는 HTTP Basic Auth를 이용하며, 이는 Stack 파트너 프로그램을 통해 제공됩니다. 공식 npm SDK는 없으므로 직접 REST API 호출을 사용해야 합니다.

사전 요구사항

  • AppFolio Stack 파트너 계정 (appfolio.com/stack)
  • AppFolio에서 발급받은 클라이언트 ID 및 클라이언트 시크릿
  • Node.js 18+ 또는 Python 3.10+

지침

1단계: API 자격 증명 얻기

# AppFolio Stack API 자격 증명은 파트너 프로그램을 통해 제공됩니다.
# 1. appfolio.com/stack/become-a-partner에서 신청
# 2. 통합 검토 완료
# 3. 공급자가 발급한 기본 URL 및 자격 증명 전달 지침 수신
# 승인된 비밀 관리자에 값을 저장합니다. 로컬 개발에 필요한 경우
# 다음 비밀 템플릿만 커밋하세요:
cat > .env.example << 'ENVFILE'
APPFOLIO_CLIENT_ID=
APPFOLIO_CLIENT_SECRET=
APPFOLIO_BASE_URL=
ENVFILE

# .env는 무시됩니다. 승인된 로컬 비밀 흐름을 통해서만 채우세요.

2단계: API 클라이언트 생성

// src/appfolio-client.ts
import axios, { AxiosInstance } from 'axios';

class AppFolioClient {
  private api: AxiosInstance;

  constructor() {
    this.api = axios.create({
      baseURL: process.env.APPFOLIO_BASE_URL,
      auth: {
        username: process.env.APPFOLIO_CLIENT_ID!,
        password: process.env.APPFOLIO_CLIENT_SECRET!,
      },
      headers: { 'Content-Type': 'application/json' },
      timeout: 30000,
    });
  }

  async verifyConnection(): Promise<boolean> {
    try {
      const response = await this.api.get('/properties');
      console.log(`연결 성공! ${response.data.length}개의 속성을 찾았습니다.`);
      return true;
    } catch (error: any) {
      console.error(`연결 실패: ${error.response?.status} ${error.message}`);
      return false;
    }
  }

  get http(): AxiosInstance { return this.api; }
}

export { AppFolioClient };

3단계: 연결 확인

# Basic Auth를 argv에 노출하지 않는 빠르고 안전한 진단 방법
NETRC_FILE="$(mktemp)"
trap 'rm -f "$NETRC_FILE"' EXIT
chmod 600 "$NETRC_FILE"
APPFOLIO_HOST="${APPFOLIO_BASE_URL#https://}"
APPFOLIO_HOST="${APPFOLIO_HOST%%/*}"
printf 'machine %s login %s password %s\n' "$APPFOLIO_HOST" \
  "$APPFOLIO_CLIENT_ID" "$APPFOLIO_CLIENT_SECRET" > "$NETRC_FILE"
curl -s -o /dev/null -w '%{http_code}\n' --netrc-file "$NETRC_FILE" \
  "${APPFOLIO_BASE_URL}/properties"

API 엔드포인트

리소스엔드포인트메서드
속성/api/v1/propertiesGET
유닛/api/v1/unitsGET
임차인/api/v1/tenantsGET
임대차/api/v1/leasesGET, POST
청구서/api/v1/billsGET, POST
공급업체/api/v1/vendorsGET
소유자/api/v1/ownersGET
보고서/api/v1/reportsGET

출력

  • 공급자가 발급한 자격 증명(승인된 비밀 경계를 통해 주입)
  • Basic Auth를 사용하는 TypeScript REST 클라이언트
  • 승인된 안전 읽기 엔드포인트에 대한 연결 결과(수정된 형태)

예시

첫 번째 인증 연습을 위해, 샌드박스 자격 증명과 공급자가 발급한 기본 URL을 로컬 비밀 메커니즘을 통해 주입한 후, 승인된 합성 속성 페이지에 대해 읽기 전용 요청을 한 번 수행하세요. 상태 코드와 클라이언트 구성 판단만 기록하고, 속성 페이로드, 클라이언트 ID, 시크릿 또는 전체 호스트/경로를 공유 로그에 출력하지 마세요. 계약, 기본 URL, 비밀 바인딩 또는 상태 결과가 확인되지 않은 경우, 쓰기 워크플로우 전에 중단하고 자격 증명 소유자가 구성을 수정하도록 하세요.

오류 처리

오류원인해결 방법
401 Unauthorized잘못된 자격 증명AppFolio에서 client_id/secret 확인
403 ForbiddenStack 파트너가 아님파트너 신청 완료
404 Not Found잘못된 기본 URLyour-company.appfolio.com 형식 사용
타임아웃네트워크 문제방화벽에서 appfolio.com HTTPS 허용 확인

리소스

다음 단계

첫 번째 속성 쿼리를 위해 appfolio-hello-world로 진행하세요.

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

Query AppFolio properties, units, and tenants via REST API. Trigger: "appfolio hello world".

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

관련 스킬