CraftFix API
Giriş yap API'yi keşfet
Sunucu ve cihaz erişimi

IP Doğrulama

İ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.

POST/verify/ip API anahtarı zorunlu

İstek parametreleri

Alan Tür Zorunlu Açıklama
ip string Hayır Doğrulanacak IPv4/IPv6 adresi. Boş bırakılırsa isteği yapan sunucunun IP adresi kullanılır.

Örnek istek

curl 
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"}'

Örnek yanıt

200 OK · application/json 
{
    "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.

Hata kodları

Kod HTTP Açıklama
missing_api_key 401 API anahtarı doğru değil. İstekte X-API-Key başlığı, Bearer jetonu veya api_key alanı bulunmuyor.
invalid_api_key 401 API anahtarı doğru değil. Gönderilen anahtar sistemde kayıtlı değil.
inactive_api_key 401 API anahtarı doğru değil. Anahtar devre dışı bırakılmış.
account_disabled 403 API anahtarının bağlı olduğu kullanıcı hesabı devre dışı.
rate_limited 429 API anahtarı için dakikalık istek sınırı aşıldı.
server_error 500 Sunucu tarafında beklenmeyen bir hata oluştu.
invalid_ip 422 Gönderilen IP adresi geçerli değil.
no_ip_rules 403 API anahtarı için tanımlı IP kuralı yok.
ip_not_allowed 403 IP adresi izinli listesinde bulunmuyor.