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 之前仍保有访问权限。如需立即终止,请使用账单门户。
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"
}
响应字段
订阅将结束的 UTC 时间(ISO 8601,仅在成功时返回)。
错误响应
错误请求——无活跃订阅可取消,或无法通过 API 取消当前订阅。
取消后的行为
| 场景 | 行为 |
|---|
| 活跃订阅 | 标记为周期结束时取消 |
| 已取消 | 返回错误 |
| 无订阅 | 返回错误 |
| 无 Stripe 订阅 ID | 返回错误(无法通过 API 取消) |
重新订阅
用户若需恢复订阅,可以:
- 使用账单门户(
/subscriptions/portal)
- 或在当前订阅结束后重新订阅
最佳实践
- 二次确认:取消前应弹出确认
- 收集原因:可询问取消原因以改进产品
- 挽留策略:可考虑折扣或暂停选项
- 清晰提示:明确展示权益截止日期
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"