API Dokümantasyonu - Zenix Scripting

Genel Bakış

Zenix Scripting API, satın aldığınız sistemlerin ve lisans anahtarlarının sunucunuzda doğrulanmasını sağlayan yüksek performanslı RESTful bir servistir.

Tüm istekler JSON formatında yanıtlanır. Başarılı doğrulama durumunda status alanı "valid" olarak döner.

Lisans Doğrulama Endpoint

GET https://zenixscripting.com/api/verify.php

İstek Parametreleri

Parametre	Tür	Zorunlu	Açıklama
`key`	string	Evet	Satın aldığınız lisans anahtarı (örn: ZNX-LIC-XXXX)
`product_id`	string	Evet	Doğrulanacak ürünün benzersiz kimliği
`ip`	string	Hayır	Lisanslı sunucunun IP adresi (IP kilidi varsa)

MTA SA (Lua) Örneği

server.lua

local LICENSE_KEY = "ZNX-LIC-ANAHTARINIZ"
local PRODUCT_ID = "znx-100"
local API_URL = "https://zenixscripting.com/api/verify.php"

function verifyLicense()
    local requestURL = string.format("%s?key=%s&product_id=%s", API_URL, LICENSE_KEY, PRODUCT_ID)
    fetchRemote(requestURL, function(data, errno)
        if errno == 0 and data then
            local response = fromJSON(data)
            if response and response.status == "valid" then
                outputDebugString("[Zenix] Lisans başarıyla doğrulandı!", 3)
            else
                outputDebugString("[Zenix] HATA: Lisans geçersiz veya süresi dolmuş!", 1)
            end
        else
            outputDebugString("[Zenix] Lisans sunucusuna ulaşılamadı (Err: " .. tostring(errno) .. ")", 1)
        end
    end)
end
addEventHandler("onResourceStart", resourceRoot, verifyLicense)

PHP Entegrasyon Örneği

verify.php

<?php
$licenseKey = 'ZNX-LIC-ANAHTARINIZ';
$productId  = 'znx-100';

$apiUrl = 'https://zenixscripting.com/api/verify.php?' . http_build_query([
    'key'        => $licenseKey,
    'product_id' => $productId
]);

$response = @file_get_contents($apiUrl);
$data = json_decode($response, true);

if ($data && ($data['status'] ?? '') === 'valid') {
    echo "Lisans geçerli: " . htmlspecialchars($data['product'] ?? '');
} else {
    echo "Lisans hatası: " . htmlspecialchars($data['message'] ?? 'Bilinmeyen hata');
}
?>

Yanıt Formatı

JSON Response (200 OK)

{
  "status": "valid",
  "message": "License verified successfully",
  "product": "Zenix Faction Script",
  "product_id": "znx-100",
  "expires": "2026-12-31"
}

Hata Kodları & Anlamları

Status Değeri	Açıklama
`valid`	Lisans anahtarı aktif ve sunucu IP adresiyle eşleşti.
`invalid`	Lisans bulunamadı, askıya alındı veya sunucu IP adresi uyumsuz.
`error`	Eksik parametre gönderildi veya sunucu API hatası oluştu.

Güvenlik & En İyi Uygulamalar

Lisans anahtarınızı istemci (client-side) dosyalarına yazmayın, daima server-side tarafta tutun.
Lua dosyalarınızı MTA SA luac.multitheftauto.com derleyicisi ile derleyip koruyun.
IP kilitleme özelliğini kullanarak lisansın başka sunucularda çalışmasını engelleyin.