Licenses

서버에서 발급된 라이선스와 활성화 정보를 조회해요.

라이선스 목록

API 키의 test 또는 live 환경과 상품 범위에 속한 라이선스를 필터와 함께 조회해요.

권한 licenses:read

쿼리 파라미터

pagenumber

조회할 페이지 번호예요.

제약 1 이상·예 1

limitnumber

페이지마다 조회할 항목 수예요.

제약 1~100·예 20

statusstring

라이선스 상태로 결과를 좁혀요.

허용 값 active, expired, revoked, pending, failed

productIdstring

상품 식별자로 라이선스를 좁혀요.

예 prod_123

keystring

라이선스 키로 결과를 좁혀요.

예 PAYRI-ABCDE-FGHJK-MNPQR-STUVW

orderIdstring

주문 식별자로 라이선스를 좁혀요.

예 ord_123

buyerEmailstring

구매자 이메일 문자열로 라이선스를 좁혀요.

예 buyer@example.com

응답

성공하면 HTTP 200과 라이선스 객체 목록을 돌려줘요.
형식은 { data, total, page, limit }예요.

오류

표에 없는 공통 오류(인증·권한, 호출 한도, 입력 검증, 서버 오류)는 에러 코드에서 확인해요.

curl 'https://api.payri.kr/v1/licenses?page=1&limit=20&status=active&productId=prod_123' \
  -H "Authorization: Bearer $PAYRI_API_KEY"

{
  "data": [
    {
      "activationCount": 1,
      "activations": [
        {
          "activatedAt": "2026-10-15T00:02:00.000Z",
          "deactivatedAt": null,
          "id": "act_123",
          "label": "내 컴퓨터",
          "lastVerifiedAt": "2026-10-15T00:02:30.000Z"
        }
      ],
      "buyerEmail": "buyer@example.com",
      "buyerName": "홍길동",
      "expiresAt": null,
      "id": "lic_123",
      "issuedAt": "2026-10-15T00:01:00.000Z",
      "key": "PAYRI-TEST-ABCDE-FGHJK-MNPQR-STUVW",
      "maxActivations": null,
      "mode": "test",
      "orderId": "ord_123",
      "orderItemId": "item_123",
      "productId": "prod_123",
      "productName": "디지털 가이드",
      "revokeReason": null,
      "revokedAt": null,
      "rotatedFrom": null,
      "status": "active"
    }
  ],
  "limit": 20,
  "page": 1,
  "total": 1
}

라이선스 단건

라이선스 식별자로 발급 정보와 활성화 정보를 조회해요.

권한 licenses:read

알아둘 점

PayRi 자동 발급 키는 live에서 PAYRI-XXXXX-XXXXX-XXXXX-XXXXX, test에서 PAYRI-TEST-XXXXX-XXXXX-XXXXX-XXXXX 형식이며 대문자 영숫자에서 0, O, 1, I, L은 제외해요. Test 주문의 키 목록·공용 키 상품에도 PAYRI-TEST-로 시작하는 키를 사용해요. 앱 API는 라이선스 앱 연동을 확인해요.

경로 파라미터

idstring필수

조회할 라이선스 식별자예요.

예 lic_123

응답

성공하면 HTTP 200과 라이선스 객체를 돌려줘요.

오류

코드	HTTP	의미
`LICENSE_NOT_FOUND`	`404`	라이선스가 없거나 키의 상품 범위 밖이에요.

표에 없는 공통 오류(인증·권한, 호출 한도, 서버 오류)는 에러 코드에서 확인해요.

curl https://api.payri.kr/v1/licenses/lic_123 \
  -H "Authorization: Bearer $PAYRI_API_KEY"

{
  "activationCount": 1,
  "activations": [
    {
      "activatedAt": "2026-10-15T00:02:00.000Z",
      "deactivatedAt": null,
      "id": "act_123",
      "label": "내 컴퓨터",
      "lastVerifiedAt": "2026-10-15T00:02:30.000Z"
    }
  ],
  "buyerEmail": "buyer@example.com",
  "buyerName": "홍길동",
  "expiresAt": null,
  "id": "lic_123",
  "issuedAt": "2026-10-15T00:01:00.000Z",
  "key": "PAYRI-TEST-ABCDE-FGHJK-MNPQR-STUVW",
  "maxActivations": null,
  "mode": "test",
  "orderId": "ord_123",
  "orderItemId": "item_123",
  "productId": "prod_123",
  "productName": "디지털 가이드",
  "revokeReason": null,
  "revokedAt": null,
  "rotatedFrom": null,
  "status": "active"
}

라이선스 객체

필드

activationCountnumber

현재 활성화 수예요.

activationsarray of objectnull 가능

이 라이선스의 활성화 정보예요.

하위 필드 5개

activatedAtstring

활성화가 시작된 시각이에요.

deactivatedAtstringnull 가능

활성화가 해제된 시각이에요.

idstring

활성화 식별자예요.

labelstringnull 가능

앱이 지정한 기기 이름이에요.

lastVerifiedAtstringnull 가능

마지막 검증 시각이에요.

buyerEmailstring

구매자 이메일 주소예요.

buyerNamestring

구매자 이름이에요.

expiresAtstringnull 가능

라이선스 만료 시각이에요.

idstring

라이선스 식별자예요.

issuedAtstring

라이선스 발급 시각이에요.

keystringnull 가능

발급된 라이선스 키예요.

maxActivationsnumbernull 가능

허용된 최대 활성화 수예요. 무제한이면 null이에요.

modestring

test 또는 live 라이선스 환경을 알려줘요.

허용 값 live, test

orderIdstring

주문 식별자예요.

orderItemIdstringnull 가능

주문 항목 식별자예요.

productIdstring

상품 식별자예요.

productNamestring

상품 이름이에요.

revokeReasonstringnull 가능

라이선스 취소 사유예요.

revokedAtstringnull 가능

라이선스가 취소된 시각이에요.

rotatedFromstringnull 가능

교체 전 라이선스 식별자예요.

statusstring

라이선스 상태예요.

허용 값 active, pending, expired, revoked

{
  "activationCount": 1,
  "activations": [
    {
      "activatedAt": "2026-10-15T00:02:00.000Z",
      "deactivatedAt": null,
      "id": "act_123",
      "label": "내 컴퓨터",
      "lastVerifiedAt": "2026-10-15T00:02:30.000Z"
    }
  ],
  "buyerEmail": "buyer@example.com",
  "buyerName": "홍길동",
  "expiresAt": null,
  "id": "lic_123",
  "issuedAt": "2026-10-15T00:01:00.000Z",
  "key": "PAYRI-TEST-ABCDE-FGHJK-MNPQR-STUVW",
  "maxActivations": null,
  "mode": "test",
  "orderId": "ord_123",
  "orderItemId": "item_123",
  "productId": "prod_123",
  "productName": "디지털 가이드",
  "revokeReason": null,
  "revokedAt": null,
  "rotatedFrom": null,
  "status": "active"
}