메인 콘텐츠로 건너뛰기
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 액세스 토큰)이 필요합니다.
서드파티 연동: API 키 인증을 사용할 때는 대신 POST /subscriptions/cancel/api를 사용하세요.
이 작업은 기간 종료 시 취소를 예약합니다. 사용자는 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
구독이 종료될 시각(ISO 8601, 성공 시에만)입니다.

오류 응답

400
잘못된 요청 — 취소할 활성 구독이 없거나 API로 취소할 수 없는 구독입니다.
401
인증 실패 — 토큰이 없거나 유효하지 않습니다.

취소 동작

시나리오동작
활성 구독기간 종료 시 취소로 표시됨
이미 취소됨오류 반환
구독 없음오류 반환
Stripe 구독 ID 없음오류(API로 취소 불가)

재활성화

사용자가 다시 이용하려면:
  1. 청구 포털(/subscriptions/portal)을 사용하거나
  2. 현재 구독이 끝난 뒤 새 구독을 만들 수 있습니다.

권장 사항

  • 확인 대화 상자: 취소 전 항상 확인을 받습니다
  • 사유 수집: 피드백을 위해 취소 사유를 묻습니다
  • 이탈 방지: 할인 또는 일시정지 옵션을 고려합니다
  • 명확한 안내: 서비스 이용 종료 시점을 사용자에게 표시합니다

POST /subscriptions/cancel/api

API 키 인증으로 사용자 구독을 취소(기간 종료 예약)합니다. 서드파티 연동에 적합합니다.

인증

API 키 인증이 필요합니다. Authorization 헤더에 API 키를 넣습니다:
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"