예정 · 2단계

License API

소프트웨어나 웹사이트에 키 활성화 기능을 연동하세요. 제품마다 고유한 API 키가 발급되며, 라이선스는 하드웨어 ID(데스크톱 앱) 또는 도메인(웹 앱)에 귀속됩니다.

엔드포인트

POST
/api/v1/licenses/activate

첫 사용 시 키를 기기(HWID) 또는 도메인에 귀속하고 라이선스 기간을 시작합니다.

POST
/api/v1/licenses/validate

앱을 실행할 때마다 키를 확인합니다. 상태, 만료일, 플랜을 반환합니다.

POST
/api/v1/licenses/reset-hwid

기기 귀속을 해제해 새 PC에서 키를 쓸 수 있게 합니다 (HWID 리셋 키 필요).

요청

POST /api/v1/licenses/validate
Authorization: Bearer <PRODUCT_API_KEY>
Content-Type: application/json

{
  "key": "ARCS-7K2QM-PX9RT-4HVNA-ZD3WE",
  "hwid": "b4f1c9…e02",          // device fingerprint, or "domain" for websites
  "version": "1.4.2"
}

응답

200 OK
{
  "valid": true,
  "status": "active",              // active | expired | banned | hwid_mismatch
  "product": "arc-studio",
  "plan": "1 Month Key",
  "expiresAt": "2026-11-22T13:05:00Z",
  "signature": "ed25519:…"         // verify offline with the public key
}

클라이언트 예제

// Node / Electron example
const res = await fetch("https://your-shop.com/api/v1/licenses/validate", {
  method: "POST",
  headers: { "Content-Type": "application/json", Authorization: `Bearer ${PRODUCT_API_KEY}` },
  body: JSON.stringify({ key, hwid: await getHwid(), version: app.getVersion() }),
});
const lic = await res.json();
if (!lic.valid) showActivationScreen(lic.status);