Entwickler

WPSubscription Entwickler-Hub

Alle API-Spezifikationen, Auth-Leitfäden und agentenlesbaren Ressourcen von WPSubscription — unter stabilen, vorhersehbaren URLs.

API-Doku lesen OpenAPI-Spezifikation ansehen

REST-API

Ein Endpunkt, acht Aktionen

WPSubscription stellt einen einzigen POST-Endpunkt für den gesamten Abonnement-Lebenszyklus bereit. Er läuft auf Ihrer eigenen WordPress-Website — wpsubscription.co veröffentlicht ausschließlich Spezifikation und Dokumentation.

Endpunkt

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

Authentifizierung

Website-gebundener API-Schlüssel im JSON-Request-Body (api_key), erzeugt unter WP-Admin → WPSubscription → Einstellungen → API-Einstellungen. Kein OAuth, keine dynamische Client-Registrierung.

Unterstützte Aktionen

cancel_subscription
pause_subscription
resume_subscription
reactivate_subscription
expire_subscription
change_status
trial_end
payment_failed

Maschinenlesbar

Ressourcen für Agenten und Integrationen

Richten Sie Ihren Client, Crawler oder Coding-Agenten auf eine dieser Adressen. Alle werden von der Hauptdomain ausgeliefert und können ohne Authentifizierung abgerufen werden.

OpenAPI 3.1

OpenAPI-Spezifikation

Vollständige Request- und Response-Schemata der Abonnement-API, inklusive typisierter Fehlercodes und eingegrenzter Berechtigungen.

/.well-known/openapi.jsonMarkdown

Authentifizierungs-Leitfaden

Wie API-Schlüssel vergeben und eingegrenzt werden, worauf ein Schlüssel zugreifen darf und worauf nicht, dazu Fehlerformate und Rate-Limit-Verhalten.

/auth.mdMCP server card

MCP-Server-Card

Schreibgeschützter MCP-Server unter /mcp für Fragen zu Preisen, Funktionen, Gateways und API. Ohne Zugangsdaten nutzbar.

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

Agent-Skills-Index

Discovery-Index für den Skill wpsubscription-api, mit Prüfsumme zur Verifizierung des Downloads.

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

KI-Ressourcenkatalog

Agentic-Resource-Discovery-Katalog: alle agentenrelevanten Ressourcen dieser Domain in einem einzigen Abruf.

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

API-Katalog

RFC-9727-Linkset, das die API mit ihrer maschinenlesbaren Beschreibung und ihrer Dokumentation verknüpft.

/.well-known/api-catalogllms.txt

llms.txt

Kuratierte Übersicht der Website für Sprachmodelle — Kernseiten, Anwendungsfälle, Entwicklerressourcen und wichtige Beiträge.

/llms.txtMarkdown

Design-System

Farb-Tokens, Typografie, Abstände und Komponentenmuster für den visuellen Stil von WPSubscription.

/design.md

Dokumentation

Anleitungen, Releases und Support

Ausformulierte Dokumentation für die Menschen hinter der Integration.

Vollständige Dokumentation

Einrichtung, Konfiguration und Funktionsanleitungen für das Plugin.

REST-API-Leitfaden

Durchgearbeitete Beispiele für jede Abonnement-Aktion, von Anfang bis Ende.

Änderungsprotokoll

Release-Historie für die kostenlose und die Pro-Edition, inklusive Deprecation-Hinweisen.

Entwickler-Support

Kontakt zum Team, wenn die Spezifikation Ihre Frage nicht beantwortet.

Entwickler-FAQ

Wo läuft die WPSubscription-API tatsächlich?

Auf Ihrer eigenen WordPress-Website, unter https://ihre-website.de/wp-json/wpsubscription/v1/action. Die Domain wpsubscription.co hostet die Spezifikation, den Auth-Leitfaden und die Dokumentation — sie verarbeitet niemals Abonnement-Anfragen. Es gibt daher keinen gemeinsamen Endpunkt und keinen Mandanten, gegen den authentifiziert wird.

Wie authentifiziere ich mich an der WPSubscription-REST-API?

Senden Sie einen website-gebundenen API-Schlüssel im Feld api_key des JSON-Request-Bodys. Der Website-Betreiber erzeugt ihn unter WP-Admin → WPSubscription → Einstellungen → API-Einstellungen und kann ihn jederzeit neu generieren. Ein Schlüssel gilt nur für die ausstellende Website und nur für die in der Spezifikation aufgeführten Lebenszyklus-Aktionen — er gewährt keinen Zugriff auf WordPress-Benutzer, Inhalte, Bestellungen oder Admin-Funktionen.

Hat WPSubscription einen MCP-Server?

Ja. Unter https://wpsubscription.co/mcp läuft ein schreibgeschützter Streamable-HTTP-MCP-Server, beschrieben durch eine Server-Card unter /.well-known/mcp/server-card.json. Er beantwortet Produktfragen — Preise, Funktionen, unterstützte Gateways, Kostenlos gegen Pro sowie einen API-Überblick — und benötigt keine Zugangsdaten. Die Abonnementdaten selbst bleiben auf Ihrer WordPress-Website und werden stattdessen über die REST-API erreicht.

Gibt es Rate-Limits für die API?

Das Plugin selbst drosselt keine Anfragen, aber der WordPress-Hoster oder dessen WAF beziehungsweise CDN begrenzt wp-json-Traffic häufig. Behandeln Sie jede 429 als verbindlich, beachten Sie den Retry-After-Header und drosseln Sie sich selbst auf etwa eine Anfrage pro Sekunde und Website.

Wie wird die API versioniert?

Die Version steht im URL-Pfad, unter /wp-json/wpsubscription/v1/. Breaking Changes erscheinen ausschließlich in einem neuen Versions-Namespace; die Request- und Response-Formate von v1 bleiben stabil, und nur additive Änderungen wie neue Aktionen oder neue optionale Felder landen in v1. Deprecations werden im Änderungsprotokoll angekündigt, bevor etwas entfernt wird.