API Documentation

Verify License

POST https://license.ntqua.com/api/verify.php{
  "license_key":"NTQ-PRO-....",
  "secret":"...",
  "app_id":"NTQ2608...",
  "domain":"customer.com",
  "version":"2026.36.3",
  "php_version":"8.2",
  "client":"VIECHOTEL_ENTERPRISE",
  "timestamp":1787388942,
  "nonce":"random-hex",
  "challenge_hash":"HMAC-SHA256(...)"
}

V3.1 hỗ trợ challenge HMAC + nonce chống replay. Có thể bật strict challenge trong Cài đặt sau khi toàn bộ client đã cập nhật.

Check Update

POST https://license.ntqua.com/api/check_update.php{
  "license_key":"NTQ-PRO-....",
  "secret":"...",
  "app_id":"NTQ2608...",
  "domain":"customer.com",
  "version":"2026.31.0"
}

NTQR1 Activation Request

POST https://license.ntqua.com/api/activation_request.php{
  "request_code":"NTQR1.eyJ2IjoxLCJ0eXBlIjoi..."
}

Response: 202 pending
{
  "request_id":"32-hex-public-id",
  "poll_url":"https://license.ntqua.com/api/activation_status.php"
}

Owner/Super Admin phê duyệt trong Admin → Kích hoạt V3.1. Server phát hành mã NTQA1 ký RSA-3072 cho đúng domain + installation + nonce + License Key + APP ID.

Activation Status

POST https://license.ntqua.com/api/activation_status.php{
  "request_id":"32-hex-public-id",
  "request_nonce":"nonce gốc trong NTQR1"
}

Khi đã phê duyệt, API trả owner_activation_code bắt đầu bằng NTQA1.

License Info

POST https://license.ntqua.com/api/license_info.php{
  "license_key":"...",
  "secret_key":"...",
  "app_id":"...",
  "domain":"customer.com"
}

Add-ons

GET https://license.ntqua.com/api/addons.php