Desarrolladores

Centro de Desarrolladores de WPSubscription

Todas las especificaciones de API, guías de autenticación y recursos legibles por agentes que publica WPSubscription, en URLs estables y predecibles.

Leer la documentación Ver la especificación OpenAPI

API REST

Un endpoint, ocho acciones

WPSubscription expone un único endpoint POST para todo el ciclo de vida de la suscripción. Se ejecuta en tu propio sitio WordPress: wpsubscription.co solo publica la especificación y la documentación.

Endpoint

POST https://{site}/wp-json/wpsubscription/v1/action

Autenticación

Clave de API vinculada al sitio, enviada en el cuerpo JSON de la petición (api_key) y generada en WP Admin → WPSubscription → Ajustes → Ajustes de API. Sin OAuth ni registro dinámico de clientes.

Acciones admitidas

cancel_subscription
pause_subscription
resume_subscription
reactivate_subscription
expire_subscription
change_status
trial_end
payment_failed

Legible por máquina

Recursos para agentes e integraciones

Apunta tu cliente, rastreador o agente de programación a cualquiera de estos recursos. Todos se sirven desde el dominio principal y pueden consultarse sin autenticación.

OpenAPI 3.1

Especificación OpenAPI

Esquemas completos de petición y respuesta de la API de suscripciones, con códigos de error tipados y permisos acotados.

/.well-known/openapi.jsonMarkdown

Guía de autenticación

Cómo se emiten y acotan las claves de API, a qué puede acceder cada clave y a qué no, además de formatos de error y límites de uso.

/auth.mdMCP server card

Tarjeta del servidor MCP

Servidor MCP de solo lectura en /mcp que responde sobre precios, funciones, pasarelas y API. No requiere credenciales.

/.well-known/mcp/server-card.jsonAgent Skills

Índice de agent skills

Índice de descubrimiento de la skill wpsubscription-api, con resumen criptográfico para verificar la descarga.

/.well-known/agent-skills/index.jsonARD catalog

Catálogo de recursos de IA

Catálogo Agentic Resource Discovery con todos los recursos para agentes de este dominio en una sola petición.

/.well-known/ai-catalog.jsonRFC 9727

Catálogo de API

Linkset RFC 9727 que enlaza la API con su descripción legible por máquina y su documentación.

/.well-known/api-catalogllms.txt

llms.txt

Mapa curado del sitio para modelos de lenguaje: páginas clave, casos de uso, recursos para desarrolladores y artículos destacados.

/llms.txtMarkdown

Sistema de diseño

Tokens de color, tipografía, espaciado y patrones de componentes para construir con el estilo visual de WPSubscription.

/design.md

Documentación

Guías, versiones y soporte

Documentación en prosa para las personas que están detrás de la integración.

Documentación completa

Guías de instalación, configuración y funciones del plugin.

Guía de la API REST

Ejemplos resueltos de cada acción de suscripción, de principio a fin.

Registro de cambios

Historial de versiones de las ediciones gratuita y Pro, con avisos de obsolescencia.

Soporte para desarrolladores

Contacta con el equipo cuando la especificación no resuelva tu duda.

Preguntas frecuentes para desarrolladores

¿Dónde se ejecuta realmente la API de WPSubscription?

En tu propio sitio WordPress, en https://tu-sitio.com/wp-json/wpsubscription/v1/action. El dominio wpsubscription.co aloja la especificación, la guía de autenticación y la documentación, pero nunca procesa peticiones de suscripción, así que no existe un endpoint compartido ni un inquilino contra el que autenticarse.

¿Cómo me autentico en la API REST de WPSubscription?

Envía una clave de API vinculada al sitio en el campo api_key del cuerpo JSON de la petición. El propietario del sitio la genera en WP Admin → WPSubscription → Ajustes → Ajustes de API y puede regenerarla cuando quiera. Una clave solo es válida para el sitio que la emitió y solo para las acciones del ciclo de vida indicadas en la especificación: no da acceso a usuarios, contenidos, pedidos ni funciones de administración de WordPress.

¿WPSubscription tiene servidor MCP?

Sí. En https://wpsubscription.co/mcp funciona un servidor MCP de solo lectura sobre Streamable HTTP, descrito por una tarjeta en /.well-known/mcp/server-card.json. Responde preguntas de producto —precios, funciones, pasarelas admitidas, gratis frente a Pro y un resumen de la API— y no necesita credenciales. Los datos de suscripción permanecen en tu sitio WordPress y se consultan a través de la API REST.

¿La API tiene límites de peticiones?

El plugin no limita las peticiones, pero el alojamiento de WordPress o su WAF o CDN suelen limitar el tráfico a wp-json. Trata cualquier 429 como definitivo, respeta su cabecera Retry-After y autolimítate a aproximadamente una petición por segundo y sitio.

¿Cómo se versiona la API?

La versión va en la ruta de la URL, bajo /wp-json/wpsubscription/v1/. Los cambios incompatibles solo aparecen en un espacio de nombres de versión nuevo; las formas de petición y respuesta de v1 se mantienen estables y en v1 solo entran cambios aditivos, como acciones nuevas o campos opcionales nuevos. Las obsolescencias se anuncian en el registro de cambios antes de eliminar nada.