跳转到主要内容
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"
}

Documentation Index

Fetch the complete documentation index at: https://docs.llmgenerator.com/llms.txt

Use this file to discover all available pages before exploring further.

概述

取消用户订阅。订阅在当前计费周期结束前仍然有效,到期后不再续费。需要 JWT 访问令牌。
**第三方集成:**请改用 POST /subscriptions/cancel/api 并以 API Key 鉴权。
本操作安排在账期结束时取消。用户在 currentPeriodEnd 之前仍保有访问权限。如需立即终止,请使用账单门户。

认证

Authorization
string
必填
JWT 访问令牌。格式: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"
}

响应字段

success
boolean
取消请求是否成功受理。
message
string
可读状态说明。
cancellationDate
string
订阅将结束的 UTC 时间(ISO 8601,仅在成功时返回)。

错误响应

400
错误请求——无活跃订阅可取消,或无法通过 API 取消当前订阅。
401
未授权——令牌无效或缺失。

取消后的行为

场景行为
活跃订阅标记为周期结束时取消
已取消返回错误
无订阅返回错误
无 Stripe 订阅 ID返回错误(无法通过 API 取消)

重新订阅

用户若需恢复订阅,可以:
  1. 使用账单门户(/subscriptions/portal
  2. 或在当前订阅结束后重新订阅

最佳实践

  • 二次确认:取消前应弹出确认
  • 收集原因:可询问取消原因以改进产品
  • 挽留策略:可考虑折扣或暂停选项
  • 清晰提示:明确展示权益截止日期

POST /subscriptions/cancel/api

使用 API Key 取消订阅,适合第三方集成。

认证

需要 API Key:
Authorization: Bearer llmgen_your_api_key_here

响应

/subscriptions/cancel 相同。
curl -X POST https://api.llmgenerator.com/api/v1/subscriptions/cancel/api \
  -H "Authorization: Bearer llmgen_your_api_key_here"