API Dokümantasyonu

1. API Anahtarı ve Secret Oluşturma

Hesabım → API Anahtarları bölümünden anahtar oluşturun. Her anahtar için API Key ve Secret Key çifti üretilir:

2. Base URL

Servis durumunu kimlik doğrulaması olmadan görmek için: GET http://www.abelsis.com.tr/api/v1/

3. İstek İmzalama (HMAC-SHA256)

Her istekte üç zorunlu header gönderilir. İmza, aşağıdaki kanonik dizenin secret key ile HMAC-SHA256 imzasıdır:

Zorunlu Header'lar

4. Örnek İstekler

$apiKey    = 'ak_live_...';
$secretKey = 'sk_live_...';
$base      = 'http://www.abelsis.com.tr/api/v1/';

$endpoint  = '/license/activate';           // base URL'e gore goreli yol
$body      = json_encode([
    'license_key' => 'LISANS-ANAHTARI-123',
    'domain'      => 'musteri.com',
]);

$timestamp = time();
$bodyHash  = hash('sha256', $body);                    // ham govdenin ozeti
$canonical = "POST\n/api/v1" . $endpoint . "\n" . $timestamp . "\n" . $bodyHash;
$signature = hash_hmac('sha256', $canonical, $secretKey);

$ch = curl_init(rtrim($base, '/') . $endpoint);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $body,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'X-Api-Key: ' . $apiKey,
        'X-Timestamp: ' . $timestamp,
        'X-Signature: ' . $signature,
    ],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

if (($response['status'] ?? '') === 'success') {
    // activate icin: $response['data']['message'] (orn. "Domain lisansa bağlandı.")
    // validate icin: $response['data']['valid'] === true
    echo "Tamam: " . ($response['data']['message'] ?? 'lisans doğrulandı');
} else {
    echo "Hata: " . ($response['errorMessage'] ?? 'bilinmeyen');
}

import hashlib, hmac, json, time, urllib.request

API_KEY    = "ak_live_..."
SECRET_KEY = "sk_live_..."
BASE       = "http://www.abelsis.com.tr/api/v1/"

def call(method, endpoint, payload=None):
    """endpoint: '/license/validate' gibi base URL'e gore goreli yol"""
    path      = "/api/v1" + endpoint                 # imzalanan tam yol
    body      = json.dumps(payload).encode() if payload is not None else b""
    timestamp = str(int(time.time()))
    body_hash = hashlib.sha256(body).hexdigest()
    canonical = "\n".join([method, path, timestamp, body_hash])
    signature = hmac.new(SECRET_KEY.encode(), canonical.encode(), hashlib.sha256).hexdigest()

    req = urllib.request.Request(
        BASE.rstrip("/") + endpoint, data=body or None, method=method)
    req.add_header("Content-Type", "application/json")
    req.add_header("X-Api-Key", API_KEY)
    req.add_header("X-Timestamp", timestamp)
    req.add_header("X-Signature", signature)

    with urllib.request.urlopen(req, timeout=20) as r:
        return json.loads(r.read())

result = call("POST", "/license/validate",
              {"license_key": "LISANS-ANAHTARI-123", "domain": "musteri.com"})
print(result["data"]["valid"])

import crypto from 'node:crypto';

const API_KEY    = 'ak_live_...';
const SECRET_KEY = 'sk_live_...';
const BASE       = 'http://www.abelsis.com.tr/api/v1/';

export async function call(method, endpoint, payload) {
  // endpoint: '/license/validate' gibi base URL'e gore goreli yol
  const path     = '/api/v1' + endpoint;              // imzalanan tam yol
  const body     = payload ? JSON.stringify(payload) : '';
  const ts       = Math.floor(Date.now() / 1000).toString();
  const bodyHash = crypto.createHash('sha256').update(body).digest('hex');
  const canonical = [method, path, ts, bodyHash].join('\n');
  const signature = crypto.createHmac('sha256', SECRET_KEY).update(canonical).digest('hex');

  const res = await fetch(BASE.replace(/\/$/, '') + endpoint, {
    method,
    headers: {
      'Content-Type': 'application/json',
      'X-Api-Key': API_KEY,
      'X-Timestamp': ts,
      'X-Signature': signature,
    },
    body: payload ? body : undefined,
  });
  return res.json();
}

API_KEY="ak_live_..."
SECRET_KEY="sk_live_..."
BASE="http://www.abelsis.com.tr/api/v1/"
METHOD="POST"
ENDPOINT="/license/validate"
BODY='{"license_key":"LISANS-ANAHTARI-123","domain":"musteri.com"}'

SIGNED_PATH="/api/v1${ENDPOINT}"          # imzalanan tam yol
TS=$(date +%s)
BODY_HASH=$(printf '%s' "$BODY" | sha256sum | cut -d' ' -f1)
SIGNATURE=$(printf '%s\n%s\n%s\n%s' "$METHOD" "$SIGNED_PATH" "$TS" "$BODY_HASH" \
  | openssl dgst -sha256 -hmac "$SECRET_KEY" -r | cut -d' ' -f1)

curl -X "$METHOD" "${BASE%/}${ENDPOINT}" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: $API_KEY" \
  -H "X-Timestamp: $TS" \
  -H "X-Signature: $SIGNATURE" \
  -d "$BODY"

5. Endpoint'ler

Gövde Örnekleri

// POST /api/v1/license/activate
{
  "license_key": "LISANS-ANAHTARI-123",
  "domain": "musteri.com"
}

// "domain" alanina tam URL de yazabilirsiniz:
// "https://www.musteri.com/panel" -> "www.musteri.com"

// POST /api/v1/license/validate
{
  "license_key": "LISANS-ANAHTARI-123",
  "domain": "musteri.com"
}

// domain gonderilmezse yalnizca lisans durumu kontrol edilir
{
  "license_key": "LISANS-ANAHTARI-123"
}

6. Yanıt Formatı

{
  "status": "success",
  "systemTime": 1735689600,
  "data": {
    "license_key": "LISANS-ANAHTARI-123",
    "valid": true,
    "status": "active",
    "checked_at": "2026-09-30T04:10:05+03:00",
    "domain": "musteri.com",
    "domain_registered": true,
    "domain_allowed": true
  }
}

{
  "status": "error",
  "errorCode": "SIGNATURE_INVALID",
  "errorMessage": "İmza doğrulaması başarısız.",
  "systemTime": 1735689600
}

validate isteğinde lisans geçersizse HTTP 200 döner ve data.valid = false olur (istemci tarafı hata değil, doğrulama sonucudur).

7. Hata Kodları

8. Limitler ve Güvenlik

9. Servis Durumu

Bu endpoint imza gerektirmez; sunucunun ayakta olduğunu doğrulamak için kullanabilirsiniz:

curl http://www.abelsis.com.tr/api/v1/