Erişim doğrulaması,
tek bir API ile.

Genel bakış

CraftFix API, uygulamalarınıza erişim izni verirken kullanabileceğiniz üç doğrulama yöntemi sunar. Her istek önce bir API anahtarı ile doğrulanır; ardından seçtiğiniz yöntem çalıştırılır.

Hızlı başlangıç

Panelden aldığınız API anahtarını kullanarak ilk isteğinizi gönderin. Aşağıdaki örnek IP doğrulaması yapar.

curl -X POST https://api.craftfix.com.tr/verify/ip \
  -H "X-API-Key: cfk_live_9f2c4a7d1e6b8c3f" \
  -H "Content-Type: application/json" \
  -d '{"ip":"203.0.113.24"}'

Anahtarınızı gövdede api_key alanıyla veya Authorization: Bearer … başlığıyla da gönderebilirsiniz.

Kimlik doğrulama

API anahtarı her istekte zorunludur. Önerilen yöntem X-API-Key başlığıdır. Anahtar geçersizse doğrulama yöntemi çalıştırılmaz ve 401 yanıtı döner.

İstekte gönderilen IP adresini (veya isteği yapan sunucunun IP adresini) API anahtarına tanımlı izinli IP listesiyle karşılaştırır.

İstek parametreleri

Örnek istek

curl -X POST https://api.craftfix.com.tr/verify/ip \
  -H "X-API-Key: cfk_live_9f2c4a7d1e6b8c3f" \
  -H "Content-Type: application/json" \
  -d '{"ip":"203.0.113.24"}'

{
    "success": true,
    "valid": true,
    "method": "ip",
    "message": "IP adresi doğrulandı.",
    "data": {
        "ip": "203.0.113.24",
        "matched_rule": "203.0.113.0/24"
    },
    "meta": {
        "request_id": "req_9f3a1c7b2d4e6f80",
        "timestamp": "2026-01-01T12:00:00+03:00"
    }
}

Notlar

• IPv4, IPv6 ve CIDR gösterimi desteklenir. Örnek: 203.0.113.24, 10.0.0.0/8, 2001:db8::/32.
• API anahtarı için en az bir IP kuralı tanımlanmış olmalıdır. Kural yoksa doğrulama reddedilir.
• Kurallar yönetici panelinden API anahtarı detay sayfasında yönetilir.

Bu yönteme özel hatalar

Lisans anahtarının var olup olmadığını, API anahtarının bağlı olduğu hesaba aitliğini, durumunu ve son kullanma tarihini kontrol eder.

İstek parametreleri

Örnek istek

curl -X POST https://api.craftfix.com.tr/verify/license \
  -H "X-API-Key: cfk_live_9f2c4a7d1e6b8c3f" \
  -H "Content-Type: application/json" \
  -d '{"license_key":"CFX-7K2M-9QX4-ABCD-EFGH"}'

{
    "success": true,
    "valid": true,
    "method": "license",
    "message": "Lisans anahtarı doğrulandı.",
    "data": {
        "license_key": "CFX-7K2M-••••••-EFGH",
        "label": "Örnek Lisans",
        "product": "CraftFix Panel",
        "status": "active",
        "expires_at": "2027-01-01 00:00:00",
        "days_left": 412
    },
    "meta": {
        "request_id": "req_9f3a1c7b2d4e6f80",
        "timestamp": "2026-01-01T12:00:00+03:00"
    }
}

Notlar

• Lisans, API anahtarının sahibi olan hesaba ait olmalıdır veya o hesaba Kullanım yetkisiyle paylaşılmış olmalıdır.
• Durumu active olmayan veya son kullanma tarihi geçmiş lisanslar reddedilir.
• Başarılı her doğrulama lisansın son doğrulama zamanını ve sayaçlarını günceller.

Bu yönteme özel hatalar

API anahtarına tanımlanmış gizli kelimeyi, istekte gönderilen değerle karşılaştırır. Kelime veritabanında hashlenmiş olarak saklanır.

İstek parametreleri

Örnek istek

curl -X POST https://api.craftfix.com.tr/verify/keyword \
  -H "X-API-Key: cfk_live_9f2c4a7d1e6b8c3f" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"craftfix-2026"}'

{
    "success": true,
    "valid": true,
    "method": "keyword",
    "message": "Gizli kelime doğrulandı.",
    "data": {
        "keyword_verified": true
    },
    "meta": {
        "request_id": "req_9f3a1c7b2d4e6f80",
        "timestamp": "2026-01-01T12:00:00+03:00"
    }
}

Notlar

• Gizli kelime yönetici panelinden API anahtarına tanımlanır.
• Kelime karşılaştırması büyük/küçük harfe duyarlıdır ve düz metin olarak saklanmaz.
• Yanlış denemeler Doğrulama Kayıtları ekranında görüntülenebilir.

Bu yönteme özel hatalar

Yanıt formatı

Her yanıt aynı temel alanları içerir. Doğrulama başarılıysa success ve valid alanları true olur.

Hata kodları

Hatalı yanıtlarda HTTP durum kodu ve makine tarafından okunabilir bir code alanı döner.

Limitler ve CORS

Üretim ortamında API anahtarlarını istemci tarafında (tarayıcı JavaScript'i) tutmamanız önerilir. Doğrulamayı kendi sunucunuzdan yapın.