sayren Docs
상점 설정

요금제·사용량 조회

현재 요금제(`plan.code`·`plan.name`), 구독 상태, 사용량 기간, 요금제 한도(`limits`, null은 한도 없음), 이번 기간 사용량을 준다. `aiActions`는 AI 작업 한도 요약이다. 결제 수단과 청구 금액은 싣지 않는다. 판매 수수료는 모든 요금제 0%다.

GET
/v1/store/subscription

현재 요금제(plan.code·plan.name), 구독 상태, 사용량 기간, 요금제 한도(limits, null은 한도 없음), 이번 기간 사용량을 준다. aiActions는 AI 작업 한도 요약이다. 결제 수단과 청구 금액은 싣지 않는다. 판매 수수료는 모든 요금제 0%다.

Authorization

accessToken
headerAuthorizationBearer <token>

Sayren 계정 토큰(로그인 토큰 또는 개인 액세스 토큰, RFC 9068 JWT)

Header Parameters

X-Store-Id*string

대상 상점 id. 토큰의 상점 범위 밖이면 403 STORE_NOT_GRANTED, 없으면 400 STORE_ID_REQUIRED다

Response Body

성공

application/json
  1. response
meta*
data*
error*|null
curl -X GET 'https://api.sayren.io/v1/store/subscription' \  -H 'X-Store-Id: string'
{  "meta": {    "status": 200,    "code": "OK",    "message": "OK",    "isSuccess": true  },  "data": {    "plan": {      "code": "BETA",      "name": "string"    },    "status": "ACTIVE",    "interval": "MONTH",    "cancelAtPeriodEnd": true,    "period": {      "start": "string",      "end": "string"    },    "limits": {      "liveOrdersMonthly": 0,      "seatsIncluded": 0,      "aiActionsMonthly": 0,      "aiReadsMonthly": 0,      "customDomains": 0,      "webhooks": 0,      "socialProviders": 0,      "emailsMonthly": 0,      "storefrontRequestsMonthly": 0,      "apiLogRetentionDays": 0,      "auditLogRetentionDays": 0,      "storefrontPreviewHoursMonthly": 0,      "storefrontBuildMinutesMonthly": 0,      "adminApiRequestsMonthly": 0    },    "features": {      "adminApi": true,      "analytics": true,      "storeClone": true,      "removeBadge": true    },    "usage": {      "liveOrders": 0,      "aiActions": 0,      "aiReads": 0,      "storefrontRequests": 0,      "adminApiRequests": 0,      "emails": 0,      "storefrontPreviewMinutes": 0,      "storefrontBuildMinutes": 0,      "seats": 0,      "customDomains": 0,      "webhooks": 0    },    "aiActions": {      "limit": 0,      "used": 0,      "resetsAt": "string"    },    "aiReads": {      "limit": 0,      "used": 0,      "resetsAt": "string"    },    "salesFeePercent": 0  },  "error": null}