Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

Migra entre versiones de la API de AppFolio y maneja cambios en los endpoints.

¿Qué es tons-of-skills-marketplace?

Esta habilidad automatiza el proceso de actualización y migración entre versiones de la API REST de AppFolio, una plataforma de gestión de propiedades. Detecta la versión actual de la API utilizada, verifica contra la última versión disponible y aplica transformaciones de esquema a objetos como propiedades e inquilinos. Incluye estrategias de reversión automática en caso de fallo, migración de endpoints (incluyendo cambios de paginación offset a cursor), y ejecuta una suite de pruebas de humo contra un entorno de staging antes de desplegar a producción. Es útil para desarrolladores que mantienen integraciones con AppFolio y necesitan actualizar sus sistemas sin interrupciones. Soporta la ejecución como skill en plataformas de agentes de IA como Claude Code, Cursor o Codex, y se activa con el comando "appfolio upgrade". Proporciona detección de versiones, migración de esquemas, manejo de errores específicos y logs de reversión.

Compatible con✓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-upgrade-migration

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Actualización y Migración de AppFolio

Descripción General

Las integraciones de gestión de propiedades de AppFolio dependen de endpoints REST versionados de la API que evolucionan con la plataforma. Las actualizaciones pueden renombrar campos en objetos de propiedad e inquilino, cambiar modelos de paginación, desaprobar endpoints de órdenes de trabajo y alterar el flujo de autenticación básica. Esta habilidad detecta tu versión actual de la API, mapea formas de respuesta obsoletas a reemplazos y revierte automáticamente si la nueva versión falla.

Prerrequisitos

  • Prefijo de versión de API actual documentado (ej., /api/v1/)
  • Acceso al registro de cambios y notas de la versión de la API de AppFolio
  • Entorno de staging con datos de prueba de propiedades e inquilinos
  • ID de cliente y secreto almacenados en variables de entorno
  • Suite de pruebas de integración existente que cubra los endpoints principales

Instrucciones

  1. Ejecuta la detección de versión para comparar tu versión activa de la API contra la última.
  2. Revisa el registro de cambios de AppFolio para cambios importantes entre las dos versiones.
  3. Aplica las transformaciones de migración de esquema a los objetos de respuesta de propiedad e inquilino.
  4. Actualiza las URL de los endpoints del prefijo de versión antiguo al nuevo.
  5. Cambia la paginación de desplazamiento a basada en cursor si la nueva versión lo requiere.
  6. Ejecuta la suite de pruebas de humo contra staging para verificar que todos los endpoints respondan.
  7. Despliega a producción con la estrategia de reversión habilitada.
  8. Monitorea los registros de errores para respuestas 410/401 que indiquen pasos de migración omitidos.

Salida

Después de una migración exitosa, la habilidad produce:

  • Un objeto VersionInfo que confirma la versión actual, la última y las obsoletas
  • Objetos de propiedad e inquilino transformados que coinciden con el nuevo esquema
  • Resultados de pruebas de humo para los endpoints de propiedades, inquilinos, órdenes de trabajo y contabilidad
  • Entradas de registro de reversión si algún endpoint retrocedió a la versión anterior

Detección de Versión

interface VersionInfo { current: string; latest: string; deprecated: string[]; }

async function detectApiVersion(baseUrl: string, headers: Record<string, string>): Promise<VersionInfo> {
  const res = await fetch(`${baseUrl}/api/status`, { headers });
  const body = await res.json();
  const current = res.headers.get("X-AppFolio-Api-Version") ?? body.api_version;
  const deprecated: string[] = body.deprecated_versions ?? [];
  if (deprecated.includes(current)) {
    console.warn(`Version ${current} is deprecated. Migrate to ${body.latest_version}.`);
  }
  return { current, latest: body.latest_version, deprecated };
}

Migración de Esquema

interface LegacyProperty { address_line1: string; unit_count: number; mgr_id: string; }
interface CurrentProperty { street_address: string; total_units: number; manager_id: string; }

function migrateProperty(old: LegacyProperty): CurrentProperty {
  return { street_address: old.address_line1, total_units: old.unit_count, manager_id: old.mgr_id };
}

interface LegacyTenant { lease_end: string; balance_due: number; }
interface CurrentTenant { lease_expiry_date: string; outstanding_balance: number; }

function migrateTenant(old: LegacyTenant): CurrentTenant {
  return { lease_expiry_date: old.lease_end, outstanding_balance: old.balance_due };
}

Estrategia de Reversión

async function versionAwareRequest(
  baseUrl: string, path: string, headers: Record<string, string>,
  targetVersion: string, fallbackVersion: string
): Promise<any> {
  const res = await fetch(`${baseUrl}/api/${targetVersion}${path}`, { headers });
  if (res.status === 410 || res.status === 404) {
    console.warn(`${targetVersion} rejected; falling back to ${fallbackVersion}`);
    const fallback = await fetch(`${baseUrl}/api/${fallbackVersion}${path}`, { headers });
    if (!fallback.ok) throw new Error(`Fallback failed: ${fallback.status}`);
    return fallback.json();
  }
  if (!res.ok) throw new Error(`Request failed: ${res.status}`);
  return res.json();
}

Ejemplos

// Detect version and migrate if needed
const info = await detectApiVersion("https://acme.appfolio.com", authHeaders);
if (info.deprecated.includes(info.current)) {
  const oldProps = await fetchLegacyProperties();
  const migrated = oldProps.map(migrateProperty);
  await smokeTestEndpoints("https://acme.appfolio.com", authHeaders);
}

Manejo de Errores

Problema de MigraciónSíntomaSolución
Prefijo de versión obsoleto410 Gone en cada solicitudActualizar la URL base al prefijo de la última versión
Campos de propiedad renombradosValores undefined en la sincronización de propiedadesAplicar la transformación migrateProperty
Desplazamiento de paginación eliminadoConjuntos de resultados vacíos después de la página unoCambiar a paginación basada en cursor
Encabezado de autenticación rechazado401 Unauthorized después de la actualizaciónRegenerar secreto de cliente, actualizar variables de entorno
Cambio en el sobre del webhookErrores de análisis en el manejador de eventosActualizar el analizador de carga útil para el nuevo sobre

Recursos

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

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

Skills relacionados