---
title: "Espace développeurs WPSubscription"
canonical: "https://wpsubscription.co/fr/developers/"
lang: "fr"
description: "Spécification de l’API REST, guide d’authentification, serveur MCP et compétences d’agent pour WPSubscription : toutes les ressources lisibles par une machine pour développer autour des abonnements WooCommerce."
---

Développeurs

# Espace développeurs WPSubscription

Toutes les spécifications d’API, tous les guides d’authentification et toutes les ressources lisibles par un agent publiés par WPSubscription, à des URL stables et prévisibles.

[Lire la documentation de l’API](https://docs.wpsubscription.co/en/wpsubscription-rest-api-integration)[Voir la spécification OpenAPI](https://wpsubscription.co/.well-known/openapi.json)

Point d’accès

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

Actions prises en charge

-   cancel\_subscription
-   pause\_subscription
-   resume\_subscription
-   reactivate\_subscription
-   expire\_subscription
-   change\_status
-   trial\_end
-   payment\_failed

API REST

## Un seul point d’accès, huit actions

WPSubscription expose un unique point d’accès POST pour tout le cycle de vie d’un abonnement. Il s’exécute sur votre propre site WordPress : wpsubscription.co publie uniquement la spécification et la documentation.

Point d’accès

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

### Authentification

Clé d’API propre au site, transmise dans le corps JSON de la requête (api\_key) et générée dans l’administration WordPress → WPSubscription → Settings (Réglages) → API Settings. Ni OAuth, ni enregistrement dynamique de clients.

### Actions prises en charge

-   cancel\_subscription
-   pause\_subscription
-   resume\_subscription
-   reactivate\_subscription
-   expire\_subscription
-   change\_status
-   trial\_end
-   payment\_failed

Lisible par une machine

## Ressources pour agents et intégrations

Dirigez votre client, votre robot d’indexation ou votre agent de code vers l’une de ces ressources. Toutes sont servies depuis le domaine racine et peuvent être récupérées sans authentification.

-   OpenAPI 3.1

    ### [Spécification OpenAPI](https://wpsubscription.co/.well-known/openapi.json)

    Les schémas complets des requêtes et des réponses de l’API des abonnements, avec les codes d’erreur typés et les autorisations par périmètre.

    `/.well-known/openapi.json`

-   Markdown

    ### [Guide d’authentification](https://wpsubscription.co/auth.md)

    Comment les clés d’API sont émises et limitées à un périmètre, ce que chaque clé peut ou ne peut pas atteindre, ainsi que le format des erreurs et le comportement des limites de débit.

    `/auth.md`

-   MCP server card

    ### [Fiche du serveur MCP](https://wpsubscription.co/.well-known/mcp/server-card.json)

    Serveur MCP en lecture seule à l’adresse /mcp, qui répond aux questions sur les tarifs, les fonctionnalités, les passerelles de paiement et l’API. Aucun identifiant requis.

    `/.well-known/mcp/server-card.json`

-   Agent Skills

    ### [Index des compétences d’agent](https://wpsubscription.co/.well-known/agent-skills/index.json)

    Index de découverte de la compétence wpsubscription-api, avec une empreinte qui permet aux clients de vérifier ce qu’ils ont téléchargé.

    `/.well-known/agent-skills/index.json`

-   ARD catalog

    ### [Catalogue des ressources IA](https://wpsubscription.co/.well-known/ai-catalog.json)

    Catalogue de découverte des ressources pour agents, qui répertorie en une seule requête toutes les ressources destinées aux agents sur ce domaine.

    `/.well-known/ai-catalog.json`

-   RFC 9727

    ### [Catalogue d’API](https://wpsubscription.co/.well-known/api-catalog)

    Ensemble de liens RFC 9727 qui relie l’API à sa description lisible par une machine et à sa documentation destinée aux humains.

    `/.well-known/api-catalog`

-   llms.txt

    ### [llms.txt](https://wpsubscription.co/llms.txt)

    Guide du site généré pour les modèles de langage : ce qu’est WPSubscription, les tarifs, ce qui est gratuit et ce qui est payant, les pages clés et un index des pages par langue (plus /llms-full.txt, avec le texte intégral des pages produit).

    `/llms.txt`

-   Markdown

    ### [Système de design](https://wpsubscription.co/design.md)

    Les variables de couleur, la typographie, les espacements et les composants pour créer dans le style visuel de WPSubscription.

    `/design.md`

Documentation

## Guides, versions et assistance

La documentation rédigée pour les personnes qui réalisent l’intégration.

-   ### [Documentation complète](https://docs.wpsubscription.co/en)

    Des guides d’installation, de configuration et de fonctionnalités pour le plugin.

-   ### [Guide de l’API REST](https://docs.wpsubscription.co/en/wpsubscription-rest-api-integration)

    Des exemples détaillés de chaque action sur les abonnements, de bout en bout.

-   ### [Journal des modifications](https://wpsubscription.co/fr/changelog/)

    L’historique des versions des éditions gratuite et Pro, avec les avis de dépréciation.

-   ### [Assistance développeurs](https://wpsubscription.co/fr/contact/)

    Contactez l’équipe lorsque la spécification ne répond pas à votre question.

## FAQ développeurs

### Où l’API WPSubscription s’exécute-t-elle réellement ?

Sur votre propre site WordPress, à l’adresse https://your-site.com/wp-json/wpsubscription/v1/action. Le domaine wpsubscription.co héberge la spécification, le guide d’authentification et la documentation. Il ne traite jamais de requêtes d’abonnement : il n’existe donc ni point d’accès partagé ni locataire auprès duquel s’authentifier.

### Comment s’authentifier auprès de l’API REST de WPSubscription ?

Envoyez une clé d’API propre au site dans le champ api\_key du corps JSON de la requête. Le propriétaire du site la génère dans l’administration WordPress → WPSubscription → Settings (Réglages) → API Settings, et peut la régénérer à tout moment. Une clé n’est valable que pour le site qui l’a émise et uniquement pour les actions du cycle de vie des abonnements listées dans la spécification : elle ne donne accès ni aux utilisateurs WordPress, ni au contenu, ni aux commandes, ni aux fonctions d’administration.

### WPSubscription propose-t-il un serveur MCP ?

Oui. Un serveur MCP en lecture seule, en Streamable HTTP, tourne à l’adresse https://wpsubscription.co/mcp et est décrit par une fiche de serveur dans /.well-known/mcp/server-card.json. Il répond aux questions sur le produit (tarifs, fonctionnalités, passerelles prises en charge, gratuit ou Pro, aperçu de l’API) et ne demande aucun identifiant. Les données d’abonnement restent sur votre site WordPress et s’obtiennent par l’API REST.

### L’API a-t-elle des limites de débit ?

Le plugin ne limite pas les requêtes, mais l’hébergeur WordPress, son pare-feu applicatif (WAF) ou son CDN limitent souvent le trafic wp-json. Considérez tout code 429 comme faisant foi, respectez son en-tête Retry-After et limitez-vous à environ une requête par seconde et par site, par courtoisie.

### Comment l’API est-elle versionnée ?

La version figure dans le chemin de l’URL, sous /wp-json/wpsubscription/v1/. Les changements incompatibles ne sortent que dans un nouvel espace de noms de version ; la forme des requêtes et des réponses de la v1 reste stable, et seuls des ajouts, comme de nouvelles actions ou de nouveaux champs facultatifs, arrivent dans la v1. Les dépréciations sont annoncées dans le journal des modifications avant tout retrait.
