API Dokümantasyonu

Lisans yönetim sistemimizle entegre olmak için ihtiyacınız olan tüm uç noktalar, örnek kodlar ve test araçları.

Başlangıç

API servisimiz REST mimarisi üzerine kuruludur. Tüm istekler standart HTTP metodlarını (GET, POST) kullanır ve yanıtlar JSON formatında döner.

Base URL: https://api.siteniz.com/ (veya dosyaların bulunduğu dizin)

Kimlik Doğrulama

Tüm API isteklerinde, size özel atanan api_key parametresini göndermeniz gerekmektedir. Bu anahtar, isteğin Header, GET veya POST parametresi olarak iletilebilir (uç noktaya göre değişir).

Hız Sınırları (Rate Limiting)

Sistem güvenliği ve kararlılığı için belirli hız sınırları uygulanmaktadır. Bu sınırlar IP adresi ve API Anahtarı bazında takip edilir.

Standart Kullanıcılar

Dakikada maksimum 100 istek.

Premium IP Sahipleri

Dakikada maksimum 750 istek (Premium ayrıcalık).

* Hız sınırını aşmanız durumunda IP adresiniz geçici olarak engellenebilir (Süre: 750 dakika). Günde 750'den fazla ihlal durumunda API anahtarınız pasife alınır.

GET Kullanıcı Bilgileri
get_user_info.php

Kullanıcının hesap detaylarını, üyelik paketini ve bakiyesini getirir.

Parametreler
api_key Zorunlu Kullanıcıya özel API erişim anahtarı. 
curl -X GET "https://api.724license.com/get_user_info.php?api_key=YOUR_API_KEY"
$response = file_get_contents("https://api.724license.com/get_user_info.php?api_key=YOUR_API_KEY");
$data = json_decode($response, true);
print_r($data);
import requests
res = requests.get("https://api.724license.com/get_user_info.php", params={"api_key": "YOUR_API_KEY"})
print(res.json())
POST Bakiye Sorgulama
check_balance.php

Kullanıcının güncel bakiyesini sorgular.

Parametreler
api_key Zorunlu API Anahtarı (POST Body içinde gönderilmelidir). 
curl -X POST "https://api.724license.com/check_balance.php" \
     -d "api_key=YOUR_API_KEY"
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.724license.com/check_balance.php");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query(['api_key' => 'YOUR_KEY']));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
GET Ürün Listesi
productList.php

Sistemde mevcut olan ve satın alınabilir tüm ürünleri, kodları ve fiyatlarıyla listeler.

{
    "success": true,
    "products": [
        {
            "product_code": "cpanel",
            "product_name": "cPanel License",
            "price": "10.00"
        }
    ]
}
POST Lisans Satın Alma
buy-license.php

Belirtilen IP adresi için yeni bir lisans satın alır. Bakiye kontrolü yapılır ve başarılı olursa lisans durumu "beklemede" (waiting) olarak işaretlenir.

Bu uç nokta Rate Limit korumasına tabidir. Dakikada 750 isteği geçmeyiniz.
Parametreler
api_key Zorunlu API Erişim anahtarınız.
product Zorunlu Ürün kodu (Örn: cpanel, litespeed). Ürün listesinden alınır.
ip_address Zorunlu Lisanslanacak sunucunun IP adresi.
period Zorunlu Lisans periyodu (Genellikle monthly).
Örnek Yanıtlar
// Başarılı
{
    "success": true,
    "message": "Lisans başarıyla satın alındı. İşlem bekliyor."
}
// Hata
{
    "success": false,
    "message": "Yetersiz bakiye"
}
API Test Konsolu
POST Lisans Yenileme
renew_license.php

Süresi dolan veya dolmak üzere olan bir lisansı 1 ay (varsayılan) uzatır.

Parametreler
api_key Zorunlu API Anahtarı.
product_code Zorunlu Yenilenecek ürünün kodu.
ip (veya ip_address) Zorunlu Lisanslı IP adresi.
GET Lisanslarım
get_licenses.php

Kullanıcının sahip olduğu tüm lisansları, durumlarını ve kalan sürelerini listeler.

const axios = require('axios');

axios.get('https://api.724license.com/get_licenses.php', {
    params: { api_key: 'YOUR_API_KEY' }
})
.then(response => {
    console.log(response.data);
})
.catch(error => {
    console.error(error);
});
$json = file_get_contents("https://api.724license.com/get_licenses.php?api_key=KEY");
$data = json_decode($json, true);
foreach($data['licenses'] as $license) {
    echo $license['product_name'] . " - " . $license['remaining_days'] . " gün kaldı";
}