White-label API

Lisans API Entegrasyon Rehberi

Ürün, bakiye ve lisans operasyonlarını kendi yazılımınızdan yönetmek için kullanılan temiz endpoint yapısı. Yeni entegrasyonlarda URL sonunda dosya uzantısı kullanılmaz.

Base URL
https://api.724license.com

Kimlik Doğrulama

Tüm istekler HTTPS üzerinden gönderilmelidir. En güvenli kullanım Bearer token headerıdır. GET örneklerinde okunabilirlik için token query parametresi de gösterilir.

Authorization: Bearer API_ANAHTARINIZ
Content-Type: application/json
Öneri: Canlı ortamda tokenı query string yerine header içinde gönderin. Query string web sunucusu loglarına daha kolay düşebilir.

Sandbox Davranışı

Sandbox açık olduğunda lisans operasyonları yalnız panel veritabanına test kaydı yazar. Uzak lisans ağına canlı işlem gönderilmez.

  • Ürün ve bakiye endpointleri her zaman panel veritabanından okunur.
  • Lisans oluşturma, yenileme, askıya alma, askıdan çıkarma, IP değişimi ve core güncelleme sandbox modda test kaydı üretir.
  • Canlıya geçmeden önce aynı IP ve ürün kodlarıyla test akışını tamamlayın.

Endpointler

Ürün Listesi

https://api.724license.com/v1/products
GET POST

Satışa açık ürünleri, ürün kodlarını ve kredi fiyatlarını listeler.

GET örneği
curl "https://api.724license.com/v1/products?token=API_ANAHTARINIZ"
POST örneği
curl -X POST "https://api.724license.com/v1/products" \
  -H "Authorization: Bearer API_ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -d '{"token":"API_ANAHTARINIZ"}'
Gerekli alanlar

token

Başarılı yanıt örneği
{"success":true,"count":2,"products":[{"code":"cpanel","name":"cPanel","credit_price":4}]}

Tek Ürün Bilgisi

https://api.724license.com/v1/product
GET POST

Ürün kodu veya ürün ID ile tek ürünün güncel fiyat ve görünürlük bilgisini döndürür.

GET örneği
curl "https://api.724license.com/v1/product?token=API_ANAHTARINIZ&code=cpanel"
POST örneği
curl -X POST "https://api.724license.com/v1/product" \
  -H "Authorization: Bearer API_ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -d '{"token":"API_ANAHTARINIZ","code":"cpanel"}'
Gerekli alanlar

token, code veya id

Başarılı yanıt örneği
{"success":true,"product":{"code":"cpanel","name":"cPanel","credit_price":4}}

Bakiye Sorgulama

https://api.724license.com/v1/balance
GET POST

API sahibinin mevcut kredi bakiyesini ve sandbox durumunu döndürür.

GET örneği
curl "https://api.724license.com/v1/balance?token=API_ANAHTARINIZ"
POST örneği
curl -X POST "https://api.724license.com/v1/balance" \
  -H "Authorization: Bearer API_ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -d '{"token":"API_ANAHTARINIZ"}'
Gerekli alanlar

token

Başarılı yanıt örneği
{"success":true,"account":{"balance":120,"currency":"credit","sandbox_enabled":false}}

Yeni Lisans Oluşturma

https://api.724license.com/v1/licenses/create
GET POST

Belirtilen IP ve ürün kodu için lisans satın alma işlemi başlatır.

GET örneği
curl "https://api.724license.com/v1/licenses/create?token=API_ANAHTARINIZ&type=cpanel&ip=203.0.113.10&billingcycle=1"
POST örneği
curl -X POST "https://api.724license.com/v1/licenses/create" \
  -H "Authorization: Bearer API_ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -d '{"token":"API_ANAHTARINIZ","type":"cpanel","ip":"203.0.113.10","billingcycle":1}'
Gerekli alanlar

token, type, ip, billingcycle

Başarılı yanıt örneği
{"success":true,"message":"Lisans işlemi tamamlandı.","license_id":1234}

Lisans Yenileme

https://api.724license.com/v1/licenses/renew
GET POST

Mevcut lisansın süresini seçilen periyot kadar uzatır.

GET örneği
curl "https://api.724license.com/v1/licenses/renew?token=API_ANAHTARINIZ&type=cpanel&ip=203.0.113.10&billingcycle=1"
POST örneği
curl -X POST "https://api.724license.com/v1/licenses/renew" \
  -H "Authorization: Bearer API_ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -d '{"token":"API_ANAHTARINIZ","type":"cpanel","ip":"203.0.113.10","billingcycle":1}'
Gerekli alanlar

token, type, ip, billingcycle

Başarılı yanıt örneği
{"success":true,"message":"Lisans yenilendi."}

Lisans Askıya Alma

https://api.724license.com/v1/licenses/suspend
GET POST

Aktif lisansı geçici olarak askıya alır.

GET örneği
curl "https://api.724license.com/v1/licenses/suspend?token=API_ANAHTARINIZ&type=cpanel&ip=203.0.113.10"
POST örneği
curl -X POST "https://api.724license.com/v1/licenses/suspend" \
  -H "Authorization: Bearer API_ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -d '{"token":"API_ANAHTARINIZ","type":"cpanel","ip":"203.0.113.10"}'
Gerekli alanlar

token, type, ip

Başarılı yanıt örneği
{"success":true,"message":"Lisans askıya alındı."}

Lisans Askıdan Çıkarma

https://api.724license.com/v1/licenses/unsuspend
GET POST

Askıdaki lisansı tekrar aktif eder.

GET örneği
curl "https://api.724license.com/v1/licenses/unsuspend?token=API_ANAHTARINIZ&type=cpanel&ip=203.0.113.10"
POST örneği
curl -X POST "https://api.724license.com/v1/licenses/unsuspend" \
  -H "Authorization: Bearer API_ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -d '{"token":"API_ANAHTARINIZ","type":"cpanel","ip":"203.0.113.10"}'
Gerekli alanlar

token, type, ip

Başarılı yanıt örneği
{"success":true,"message":"Lisans aktif edildi."}

Lisans IP Değişimi

https://api.724license.com/v1/licenses/change-ip
GET POST

Lisansın bağlı olduğu IP adresini yeni IP adresiyle değiştirir.

GET örneği
curl "https://api.724license.com/v1/licenses/change-ip?token=API_ANAHTARINIZ&type=cpanel&ip=203.0.113.10&newip=203.0.113.20"
POST örneği
curl -X POST "https://api.724license.com/v1/licenses/change-ip" \
  -H "Authorization: Bearer API_ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -d '{"token":"API_ANAHTARINIZ","type":"cpanel","ip":"203.0.113.10","newip":"203.0.113.20"}'
Gerekli alanlar

token, type, ip, newip

Başarılı yanıt örneği
{"success":true,"message":"IP adresi güncellendi."}

LiteSpeed Core Güncelleme

https://api.724license.com/v1/licenses/change-core
GET POST

LiteSpeed lisansındaki core/ürün tipini desteklenen hedef tipe çevirir.

GET örneği
curl "https://api.724license.com/v1/licenses/change-core?token=API_ANAHTARINIZ&type=litespeed&ip=203.0.113.10&new_type=litespeed_x_core"
POST örneği
curl -X POST "https://api.724license.com/v1/licenses/change-core" \
  -H "Authorization: Bearer API_ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -d '{"token":"API_ANAHTARINIZ","type":"litespeed","ip":"203.0.113.10","new_type":"litespeed_x_core"}'
Gerekli alanlar

token, type, ip, new_type

Başarılı yanıt örneği
{"success":true,"message":"Core bilgisi güncellendi."}

Parametre Sözlüğü

ParametreAçıklamaÖrnek
tokenAPI anahtarı. Header ile gönderildiyse body içinde gerekmez.sk_live_xxx
typeÜrün kodu. Ürün listesi endpointinden alınmalıdır.cpanel
ipLisansın bağlı olduğu mevcut IP adresi.203.0.113.10
billingcycleAy cinsinden lisans periyodu. Lifetime ürünlerde sistem kuralı uygulanır.1
newipIP değişiminde hedef IP adresi.203.0.113.20
new_typeLiteSpeed core veya ürün değişiminde hedef ürün kodu.litespeed_x_core

Sunucu Tarafı Kullanım Örnekleri

Aşağıdaki örnekler yeni lisans oluşturma endpointi üzerinden verilmiştir. Diğer endpointlerde yalnız URL ve payload alanları değişir.

PHP cURL
$payload = [
    'type' => 'cpanel',
    'ip' => '203.0.113.10',
    'billingcycle' => 1,
];

$ch = curl_init('https://api.724license.com/v1/licenses/create');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer API_ANAHTARINIZ',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode($payload),
]);
$response = json_decode(curl_exec($ch), true);
Node.js fetch
const response = await fetch('https://api.724license.com/v1/licenses/create', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer API_ANAHTARINIZ',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ type: 'cpanel', ip: '203.0.113.10', billingcycle: 1 })
});
const data = await response.json();
Python requests
import requests

response = requests.post(
    'https://api.724license.com/v1/licenses/create',
    headers={'Authorization': 'Bearer API_ANAHTARINIZ'},
    json={'type': 'cpanel', 'ip': '203.0.113.10', 'billingcycle': 1},
    timeout=60
)
data = response.json()

Hata Kodları

KodAnlamıKontrol
invalid_token API anahtarı eksik veya hatalı. Bearer token headerını veya token parametresini kontrol edin.
invalid_ip IP adresi geçerli formatta değil. IPv4 veya IPv6 adresini düz metin olarak gönderin.
product_not_found Ürün bulunamadı veya görünür değil. Ürün kodunu paneldeki görünür ürün listesinden alın.
license_exists Aynı IP ve ürün için lisans zaten var. Yeni lisans yerine yenileme veya IP değişimi akışını kullanın.
insufficient_balance İşlem için yeterli kredi yok. Bakiye yükleyin veya ürün/periyot bilgisini kontrol edin.
sandbox_license_not_found Sandbox işleminde hedef lisans bulunamadı. Önce sandbox lisans oluşturun.