Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

Configure a autenticação da API AppFolio Stack com OAuth 2.0. Use ao configurar acesso à API de gerenciamento de propriedades, registrar-se como parceiro AppFolio Stack ou configurar credenciais de cliente para chamadas de API. Gatilhos: "install appfolio", "setup appfolio", "appfolio auth", "appfolio API key".

O que é tons-of-skills-marketplace?

Esta skill configura a autenticação para a API AppFolio Stack, que usa HTTP Basic Auth com um client ID e client secret fornecidos pelo programa de parceiros AppFolio Stack. Não há SDK público npm disponível, então as chamadas são feitas diretamente via REST API. A skill oferece instruções passo a passo para obter credenciais de API, criar um cliente TypeScript com axios, e verificar a conexão de forma segura, evitando expor segredos em logs ou argumentos de linha de comando. Além disso, inclui uma tabela de endpoints da API (Properties, Units, Tenants, Leases, Bills, Vendors, Owners, Reports) e tratamento de erros comuns como 401, 403 e 404. É útil para desenvolvedores que precisam integrar sistemas de gerenciamento de propriedades com a plataforma AppFolio, suportando Node.js 18+ e Python 3.10+.

Funciona com✓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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Instalação e Autenticação do AppFolio

Visão Geral

Configure a autenticação da API AppFolio Stack. O AppFolio usa HTTP Basic Auth com um client ID e client secret, fornecidos através do programa de parceiros Stack. Não existe SDK público npm — use chamadas REST API diretas.

Pré-requisitos

  • Conta de parceiro AppFolio Stack (appfolio.com/stack)
  • Client ID e Client Secret do AppFolio
  • Node.js 18+ ou Python 3.10+

Instruções

Passo 1: Obter Credenciais da API

# As credenciais da API AppFolio Stack vêm do programa de parceiros
# 1. Candidate-se em appfolio.com/stack/become-a-partner
# 2. Conclua a revisão de integração
# 3. Receba a URL base fornecida pelo provedor e instruções de entrega de credenciais.
# Armazene os valores no gerenciador de segredos aprovado. Commit apenas este modelo
# não secreto se o desenvolvimento local exigir um:
cat > .env.example << 'ENVFILE'
APPFOLIO_CLIENT_ID=
APPFOLIO_CLIENT_SECRET=
APPFOLIO_BASE_URL=
ENVFILE

# .env permanece ignorado; preencha-o apenas através de um fluxo de segredo local aprovado.

Passo 2: Criar Cliente da 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(`Conectado! Encontradas ${response.data.length} propriedades`);
      return true;
    } catch (error: any) {
      console.error(`Falha na conexão: ${error.response?.status} ${error.message}`);
      return false;
    }
  }

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

export { AppFolioClient };

Passo 3: Verificar Conexão

# Diagnóstico rápido e editado sem colocar Basic Auth em 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"

Endpoints da API

RecursoEndpointMétodos
Propriedades/api/v1/propertiesGET
Unidades/api/v1/unitsGET
Inquilinos/api/v1/tenantsGET
Contratos de Locação/api/v1/leasesGET, POST
Faturas/api/v1/billsGET, POST
Fornecedores/api/v1/vendorsGET
Proprietários/api/v1/ownersGET
Relatórios/api/v1/reportsGET

Saída

  • Credenciais fornecidas pelo provedor injetadas através do limite de segredo aprovado
  • Cliente REST TypeScript com Basic Auth
  • Resultado de conectividade editado para o endpoint de leitura segura aprovado

Exemplos

Para um primeiro ensaio de autenticação, injete uma credencial de sandbox e a URL base fornecida pelo provedor através do mecanismo de segredo local, depois faça uma requisição somente leitura para uma página de propriedade sintética aprovada. Registre apenas o código de status e o veredito da configuração do cliente; não imprima o payload da propriedade, client ID, secret ou caminho/host completo em logs compartilhados. Se o contrato, URL base, vinculação de segredo ou resultado de status não forem verificados, pare antes de qualquer fluxo de escrita e faça o proprietário da credencial corrigir a configuração.

Tratamento de Erros

ErroCausaSolução
401 Não AutorizadoCredenciais inválidasVerifique client_id/secret do AppFolio
403 ProibidoNão é um parceiro StackComplete a inscrição de parceiro
404 Não EncontradoURL base erradaUse o formato sua-empresa.appfolio.com
TimeoutProblema de redeVerifique se o firewall permite HTTPS para appfolio.com

Recursos

Próximos Passos

Prossiga para appfolio-hello-world para sua primeira consulta de propriedade.

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

Habilidades Relacionadas