Skip to main content
POST
JavaScript
이 엔드포인트는 이미 보유한 키를 가져옵니다 — key, customer_idproduct_id은 모두 필수입니다. 이 엔드포인트는 사용자를 대신해 키 값을 생성하지 않습니다. 이미 존재하는 key을 가져오면 409 Conflict이 반환됩니다.
API를 통해 생성하거나 업데이트한 라이선스 키는 고객에게 이메일 알림을 보내지 않습니다. 고객에게 라이선스 키를 알리려면 애플리케이션에서 별도로 처리해야 합니다.

인증

Authorization
string
header
필수

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

본문

application/json
customer_id
string
필수

The customer this license key belongs to.

key
string
필수

The license key string to import.

product_id
string
필수

The product this license key is for.

activations_limit
integer<int32> | null

Maximum number of activations allowed. Null means unlimited.

expires_at
string<date-time> | null

Expiration timestamp. Null means the key never expires.

응답

License key created

brand_id
string
필수

Brand id this license key belongs to

business_id
string
필수

The unique identifier of the business associated with the license key.

created_at
string<date-time>
필수

The timestamp indicating when the license key was created, in UTC.

예시:

"2024-01-01T00:00:00.000Z"

customer_id
string
필수

The unique identifier of the customer associated with the license key.

예시:

"cus_123"

id
string
필수

The unique identifier of the license key.

예시:

"lic_123"

instances_count
integer<int32>
필수

The current number of instances activated for this license key.

key
string
필수

The license key string.

product_id
string
필수

The unique identifier of the product associated with the license key.

source
enum<string>
필수

The source of the license key - 'auto' for keys generated by payment/subscription flows, 'import' for merchant-imported keys.

사용 가능한 옵션:
auto,
import,
manual
status
enum<string>
필수

The current status of the license key (e.g., active, inactive, expired).

사용 가능한 옵션:
active,
expired,
disabled
activations_limit
integer<int32> | null

The maximum number of activations allowed for this license key.

예시:

5

expires_at
string<date-time> | null

The timestamp indicating when the license key expires, in UTC.

예시:

"2024-12-31T23:59:59.000Z"

payment_id
string | null

The unique identifier of the payment associated with the license key, if any.

subscription_id
string | null

The unique identifier of the subscription associated with the license key, if any.

마지막 수정일 2026년 8월 6일