SkyGames API Documentation for Developers

SkyGames API-yə Xoş Gəlmisiniz

API Haqqında

Bu API, SkyGames platformunda aşağıdakı əməliyyatları yerinə yetirməyinizi təmin edir:

İstifadəçi balansı sorğulama
Məhsul siyahısı və detallarını göstərmə
Kateqoriya siyahısı və detallarını göstərmə
Məhsul alışı

Kimlik Doğrulama

Bütün API çağırışları üçün Basic Authentication istifadə olunur. Hər sorğu üçün Authorization header-ında e-poçt ünvanınızı və şifrənizi base64 ilə kodlanmış olaraq göndərməlisiniz.

Authorization: Basic base64(email:password)

Nümunə PHP İstifadəsi


$email = '[email protected]';
$password = 'sifre';
$credentials = base64_encode($email . ':' . $password);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://skygames.az/api/v1/");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    'Authorization: Basic ' . $credentials
));
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);

Xəta Kodları

Kod	Açıqlama
400	Yanlış sorğu (Çatışmayan və ya xətali parametr)
401	Kimlik doğrulama məlumatları çatışmayan və ya yanlış
403	IP ünvanı icazə verilməyən siyahıda
404	İstənilən mənbə tapılmadı
500	Server xətası

IP Məhdudiyyəti

Təhlükəsizlik səbəbindən, API-yə giriş yalnız əvvəlcədən təyin edilmiş IP ünvanlarından edilə bilər. IP ünvanınızı hesabınıza daxil olduqdan sonra API Tənzimləmələri səhifəsindən əlavə edə bilərsiniz.

Cavab Formatı

Bütün API cavabları JSON formatında qaytarılır və aşağıdakı ümumi strukturа malikdir:

{
    "status": true|false,
    "data|message": "...",
    ... digər sahələr ...
}

Callback URL İstifadəsi

Alış əməliyyatlarında, sifarişin statusu tamamlandığında məlumatlandırılmaq üçün callback URL istifadə edə bilərsiniz. Sifariş statusu "completed" olduqda, sistemimiz göstərdiyiniz callback URL-inə bir POST sorğusu göndərir.

Callback Sorğusu Nümunəsi


// Callback URL-inə göndərilən POST məlumatları
{
    "order_id": "ORD123456",
    "status": "completed",
    "delivery_details": "Məhsul detalları...",
    "timestamp": "2024-01-01 12:00:00"
}

Callback İstifadə Nümunəsi (PHP)


// Satın alma sorğusu
$email = '[email protected]';
$password = 'sifre';
$credentials = base64_encode($email . ':' . $password);

$data = array(
    'product_id' => 1,
    'quantity' => 1,
    'callback_url' => 'https://sizin-saytiniz.com/callback',
    'required_fields' => array(
        'username' => 'oyuncu123',
        'server' => 'EU'
    )
);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://skygames.az/api/v1/purchase");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    'Authorization: Basic ' . $credentials,
    'Content-Type: application/json'
));
$response = curl_exec($ch);
curl_close($ch);

// Callback-i qarşılayan endpoint nümunəsi
// https://sizin-saytiniz.com/callback
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $callback_data = json_decode(file_get_contents('php://input'), true);
    
    if ($callback_data['status'] === 'completed') {
        // Sifariş tamamlandı, lazımi əməliyyatları edin
        $order_id = $callback_data['order_id'];
        $delivery_details = $callback_data['delivery_details'];
        
        // Verilənlər bazasına yadda saxla, istifadəçini məlumatlandır və s.
    }
}

Vacib Qeydlər

Callback URL-iniz HTTPS protokolunu dəstəkləməlidir
Callback sorğusu yalnız sifariş "completed" statusuna keçdikdə bir dəfə göndərilir
Callback URL seçimlidir, göstərilməzsə yalnız API cavabı ilə sifariş statusunu öyrənə bilərsiniz

Kömək və Dəstək

Hər hansı sualınız və ya probleminiz varsa, zəhmət olmasa [email protected] ünvanına e-poçt göndərin.