Pendahuluan

Selamat datang di dokumentasi API Validasi Lisensi Pasdigi. API ini memungkinkan produk Anda (plugin, software, dll.) untuk memverifikasi keabsahan lisensi secara aman dan real-time langsung ke server kami.

Cara Kerja (Alur Proxy Aman)

Untuk menjaga kerahasiaan API Key Anda, validasi lisensi menggunakan model "Server Proxy". Kunci rahasia Anda tidak pernah dimasukkan ke dalam produk yang Anda distribusikan. Alurnya adalah sebagai berikut:

1. Plugin Pembeli mengirim permintaan validasi (berisi kunci lisensi) ke Server Anda (Penjual).
2. Server Anda menerima permintaan tersebut, lalu menambahkan API Key rahasia Anda dan meneruskannya ke API Pasdigi.
3. API Pasdigi memproses permintaan dan mengirimkan status lisensi kembali ke Server Anda.
4. Server Anda meneruskan hasil status tersebut kembali ke Plugin Pembeli.

Dengan cara ini, API Key rahasia Anda tetap aman di server Anda.

Langkah 1: Dapatkan API Key Anda

Setiap toko di Pasdigi memiliki API Key rahasia yang unik. Anda bisa mendapatkan kunci ini di halaman Dashboard Toko -> Pengaturan API. Kunci ini akan digunakan pada Langkah 2.

Langkah 2: Siapkan Endpoint di Server Anda (Proxy)

Anda perlu membuat satu file PHP di server atau website Anda yang akan bertindak sebagai perantara (proxy). File ini akan menerima permintaan dari plugin Anda dan berkomunikasi dengan Pasdigi.

Buat file bernama verify-license.php (atau nama lain) di server Anda dan gunakan kode di bawah ini.

Contoh File: proxy-penjual.php

// File ini disimpan di server Anda (misal: https://website-anda.com/api/proxy-penjual.php)

header('Content-Type: application/json');

if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
    http_response_code(405);
    echo json_encode(['success' => false, 'error' => ['message' => 'Method Not Allowed']]);
    exit();
}

$input_data = json_decode(file_get_contents('php://input'), true);
$license_key = $input_data['license_key'] ?? null;
// ... (Kode lengkap ada di file contoh di bawah)

(Kode lengkap untuk file ini disediakan di bagian "File Contoh Implementasi" di bawah panduan ini)

Langkah 3: Implementasi di Plugin/Software Anda

Sekarang, di dalam kode plugin atau software yang Anda jual, panggil endpoint proxy yang baru saja Anda buat pada Langkah 2. Jangan memanggil API Pasdigi secara langsung dari sini.

Contoh File: validasi-plugin.php

// File ini ada di dalam produk yang Anda distribusikan ke pembeli

function validate_my_plugin_license($license_key, $product_id) {
    // URL menunjuk ke server proxy ANDA, bukan Pasdigi
    $seller_api_url = 'https://website-anda.com/api/proxy-penjual.php';

    $domain = $_SERVER['SERVER_NAME'];
    $data = [
        'license_key' => $license_key,
        'product_id'  => $product_id,
        'domain'      => $domain
    ];
    // ... (Kode lengkap ada di file contoh di bawah)
}

(Kode lengkap untuk file ini disediakan di bagian "File Contoh Implementasi" di bawah panduan ini)

Referensi API Pasdigi

Sebagai referensi, ini adalah detail endpoint Pasdigi yang dipanggil oleh server proxy Anda.

• Method: POST
• URL: https://pasdigi.com/api/v1/license/validate
• Headers:
  • Authorization: Bearer [API_KEY_RAHASIA_ANDA]
  • Content-Type: application/json
• Body (JSON): {"license_key": "...", "product_id": ..., "domain": "..."}

Untuk detail respon sukses dan error, silakan lihat di dalam file contoh implementasi.

Silahkan download di halaman Pasdigi Sample di Github.

Catatan:
API ini masih dalam tahap pengembangan, kami sedang mempertimbangkan izin lisensi di sisi server. Artinya ada library khusus yang tidak dimuat secara langsung di software/aplikasi. Library ini dapat dimuat di web proxy. Ini memungkinkan walaupun script dimodifikasi, library tidak akan dapat dimuat selama lisensi tidak valid. Kami sangat mempertimbangkan dan menghargai karya para developer agar hasil karya mereka tetap terjaga dari pembajakan.