Passer au contenu principal
POST
/
subscriptions
/
cancel
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/cancel \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "success": true,
  "message": "Subscription cancelled successfully",
  "cancellationDate": "2024-02-15T00:00:00Z"
}

​
Vue d’ensemble

Résilie l’abonnement de l’utilisateur. Celui-ci reste actif jusqu’à la fin de la période en cours, puis ne sera pas renouvelé. Nécessite une authentification par session (jeton d’accès JWT).
Pour les intégrations tierces : utilisez POST /subscriptions/cancel/api avec authentification par clé d’API.
Cette action planifie la résiliation en fin de période. L’accès est maintenu jusqu’à currentPeriodEnd. Pour une résiliation immédiate, utilisez le portail de facturation.

​
Authentification

​
Authorization
string
requis
Jeton d’accès JWT. Format : Bearer YOUR_ACCESS_TOKEN
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/cancel \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "success": true,
  "message": "Subscription cancelled successfully",
  "cancellationDate": "2024-02-15T00:00:00Z"
}

​
Champs de réponse

​
success
boolean
Indique si la demande de résiliation a réussi.
​
message
string
Message lisible décrivant le statut.
​
cancellationDate
string
Horodatage ISO 8601 de la fin effective de l’abonnement (en cas de succès).

​
Réponses d’erreur

​
400
Requête incorrecte : pas d’abonnement actif à résilier, ou résiliation impossible via l’API.
​
401
Non autorisé : jeton manquant ou invalide.

​
Comportement de la résiliation

ScénarioComportement
Abonnement actifRésiliation planifiée et enregistrée
Déjà résiliéErreur renvoyée
Aucun abonnementErreur renvoyée
Pas d’identifiant StripeErreur (résiliation impossible via l’API)

​
Réactivation

Pour réactiver un abonnement, l’utilisateur peut :
  1. Utiliser le portail de facturation (/subscriptions/portal)
  2. Souscrire à nouveau après la fin de la période en cours

​
Bonnes pratiques

  • Boîte de confirmation : demander confirmation avant résiliation
  • Collecte du motif : recueillir la raison du départ pour améliorer le produit
  • Offre de rétention : envisager une remise ou une pause
  • Communication claire : indiquer précisément la date de fin d’accès

​
POST /subscriptions/cancel/api

Planifie la résiliation avec authentification par clé d’API. Adapté aux intégrations tierces.

​
Authentification

Authentification par clé d’API obligatoire. Indiquez votre clé dans l’en-tête Authorization : 
Authorization: Bearer llmgen_your_api_key_here

​
Réponse

Identique à /subscriptions/cancel ci-dessus. 
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/cancel/api \
  -H "Authorization: Bearer llmgen_your_api_key_here"