Integration Guide

API Overview

Selamat datang di dokumentasi API Lisensi KaryaMe. Sistem lisensi KaryaMe memisahkan API menjadi dua bagian utama:

Public License API: Digunakan langsung di dalam software/script yang dijual kepada buyer. Tidak memerlukan token rahasia, sehingga aman dari reverse-engineering.
Kreator Private API: Digunakan di server backend milik Kreator sendiri untuk administrasi, monitoring, dan pembatalan lisensi (Revoke). Membutuhkan Kreator API Token.

Public License API (Untuk Script Buyer)

Pakai API ini di template web, WordPress plugin, atau aplikasi mobile yang kamu jual. API ini jalan tanpa Authentication Token, tapi pakai pengikatan domain (Domain Binding) dan ID instalasi unik (Installation ID).

POST

Activate License

/api/v1/license/activate

Melakukan aktivasi pertama kali untuk mendaftarkan lisensi pada domain dan instalasi tertentu.

Request Body (JSON)

Field	Type	Description
purchase_code	UUID	Kode pembelian unik pelanggan (misal: 0e236bda-2a13-4c12-acbe-xxxxxxxxx).
domain	String	Domain atau URL tempat script berjalan (misal: example.com).
installation_id	String	ID unik acak untuk mengidentifikasi database instalasi tersebut agar terhindar dari pemalsuan.

POST

Periodic License Check

/api/v1/license/check

Dipanggil secara berkala (misal: setiap hari atau setiap admin panel diakses) untuk memastikan status lisensi tetap aktif dan tidak dicabut (revoked) atau dikembalikan (refunded).

POST

Deactivate Domain

/api/v1/license/deactivate

Memutus hubungan domain saat ini dari lisensi, sehingga pelanggan bisa meng-install atau mengaktifkan ulang lisensi tersebut di domain baru (migrasi).

Kreator Private API (Untuk Server Kreator)

API ini digunakan oleh server pusat milik Kreator untuk melihat detail lisensi yang terjual, riwayat aktivasi domain, atau membuat verifikasi kustom. API ini wajib menyertakan Authorization Header.

Authorization: Bearer YOUR_API_TOKEN

GET

Verify Purchase Code (Private)

/api/v1/license/verify?code=UUID

Mengambil data lisensi secara lengkap beserta daftar riwayat domain/instalasi aktif yang terdaftar di bawah purchase code tersebut.

Response Status & Badge

Sistem Lisensi KaryaMe secara konsisten mengembalikan respon HTTP 200 dengan JSON untuk status pengecekan yang berhasil diproses. Status lisensi yang didukung:

active

Lisensi aktif dan valid untuk digunakan.

revoked

Lisensi dibatalkan atau dicabut secara manual oleh kreator/toko.

refunded

Pembelian produk telah di-refund; lisensi tidak berlaku lagi.

suspended

Lisensi dibekukan sementara karena investigasi penyalahgunaan.

expired

Masa aktif dukungan/lisensi telah habis.

Code Snippet (Activate)

curl --request POST \
  --url 'http://localhost:8080/api/v1/license/activate' \
  --header 'Content-Type: application/json' \
  --data '{
    "purchase_code": "0e236bda-2a13-4c12-acbe-xxxxxxxxx",
    "domain": "example.com",
    "installation_id": "unique-installation-uuid"
  }'

JSON Response (Activation Success)

{
  "valid": true,
  "license": {
    "status": "active",
    "type": "regular"
  },
  "activation": {
    "domain": "example.com",
    "installation_id": "unique-installation-uuid"
  },
  "item": {
    "id": 12,
    "name": "Xample Product"
  }
}

JSON Response (Activation Error)

{
  "valid": false,
  "error": "maximum activations reached (1/1)",
  "status": "active"
}

JSON Response (Private GET /verify)

{
  "valid": true,
  "purchase_code": "0e236bda-2a13-4c12-acbe-xxxxxxxxx",
  "license": {
    "type": "regular",
    "status": "active",
    "max_activations": 1
  },
  "item": {
    "id": 12,
    "name": "Xample Product",
    "url": "http://localhost:8080/products/xample-product"
  },
  "buyer": "5LinkID",
  "sold_at": "2026-08-13T03:30:00Z",
  "supported_until": null,
  "activations": [
    {
      "domain": "example.com",
      "installation_id": "unique-installation-uuid",
      "activated_at": "2026-08-13T10:35:00Z",
      "last_check_at": "2026-08-13T10:35:00Z"
    }
  ]
}