Geçiş rehberi · /api/v2

AbuseIPDB uyumlu API

Aracınız zaten AbuseIPDB APIv2 ile konuşuyorsa kodunu değiştirmenize gerek yok. Adresi ve anahtarı değiştirin; aynı istek, aynı alan adları, aynı hata biçimi. Günlük sınıra takılan sunucular için pratik bir çıkış, ya da ikinci bir göz.

Sorgu / gün10.000doğrulanmış hesap
Rapor / gün10.000ayrı sayaç
Puan kaynağı44tehdit listesi
ÜcretÜcretsizücretli plan yok

İki şeyi değiştirin

Aracınızın ayarında ya da betiğinizde AbuseIPDB adresini ve anahtarını bulun; ikisini de aşağıdakilerle değiştirin. Yol (/api/v2/…), parametreler ve Key başlığı aynı kalır.

NeÖnceSonra
Adreshttps://api.abuseipdb.com/api/v2https://ip-db.com/api/v2
AnahtarAbuseIPDB anahtarınızIP-DB anahtarınız (ipdb_…)
AbuseIPDB anahtarı burada geçerli değildir; IP-DB anahtarı hesap panelinden bir dakikada alınır. E-postanızı doğruladığınızda günlük sınır 1.000'den 10.000'e çıkar.

Hazır örnekler

Bir adresi sorgula · curl

curl -G https://ip-db.com/api/v2/check \
  --data-urlencode "ipAddress=185.220.101.1" \
  -d maxAgeInDays=90 \
  -H "Key: YOUR_IPDB_KEY" \
  -H "Accept: application/json"

# {"data": {"ipAddress": "185.220.101.1", "isPublic": true, "ipVersion": 4,
#   "isWhitelisted": false, "abuseConfidenceScore": 100, "countryCode": "DE",
#   "usageType": "Data Center/Web Hosting/Transit", "isp": "…", "domain": "…",
#   "hostnames": [], "isTor": true, "totalReports": 0, "numDistinctUsers": 0,
#   "lastReportedAt": null, "ipdb": {"scoreLabel": "critical", "blacklistSources": […], …}}}

Bir adresi bildir · curl

curl https://ip-db.com/api/v2/report \
  --data-urlencode "ip=203.0.113.7" \
  -d categories=18,22 \
  --data-urlencode "comment=SSH login attempts" \
  -H "Key: YOUR_IPDB_KEY" \
  -H "Accept: application/json"

# {"data": {"ipAddress": "203.0.113.7", "abuseConfidenceScore": 12}}

Python · requests

import requests

r = requests.get(
    "https://ip-db.com/api/v2/check",          # was https://api.abuseipdb.com/api/v2/check
    params={"ipAddress": "185.220.101.1", "maxAgeInDays": 90},
    headers={"Key": "YOUR_IPDB_KEY", "Accept": "application/json"},
    timeout=10,
)
score = r.json()["data"]["abuseConfidenceScore"]

fail2ban: engellediğini bildir

# /etc/fail2ban/action.d/ipdb.conf
[Definition]
norestored = 1
actionstart =
actionstop =
actioncheck =
actionban = curl -sSf "https://ip-db.com/api/v2/report" -H "Accept: application/json" -H "Key: <ipdb_apikey>" --data-urlencode "comment=fail2ban: <name>" --data-urlencode "ip=<ip>" --data "categories=<ipdb_category>"
actionunban =

[Init]
ipdb_apikey =
ipdb_category = 18

# /etc/fail2ban/jail.local
[sshd]
enabled = true
action = %(action_)s
         ipdb[ipdb_apikey="YOUR_IPDB_KEY", ipdb_category="18,22"]

# sudo fail2ban-client reload
Dosyayı kaydedin, jail'e ekleyin, fail2ban'ı yeniden yükleyin. Mevcut AbuseIPDB eyleminizi silmeniz gerekmez; ikisi yan yana çalışır. Yorum alanına bilerek günlük satırı koymuyoruz: içinde sunucu adınız ya da kullanıcı adları olabilir.

Birebir aynı olanlar

YollarGET /api/v2/check ve POST /api/v2/report
ParametreleripAddress, maxAgeInDays, verbose; ip, categories, comment
KimlikKey başlığı
Yanıt zarfı{"data": …} ve {"errors": [{detail, status}]}
Alan adlarıabuseConfidenceScore, countryCode, usageType, isp, domain, isTor, totalReports, numDistinctUsers, lastReportedAt…
Durum kodları401, 422, 429
BaşlıklarX-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, Retry-After
Rapor kategorileriAbuseIPDB'nin sayısal kimlikleri (ör. 18,22) kabul edilir
Aynı adres 15 dakikada bir kez bildirilebilir

Farklı olanlar

Uyumlu olan biçimdir, veri değil. Geçmeden önce bilmeniz gerekenler:

Puan bizim puanımızdırabuseConfidenceScore aynı 0–100 ölçeğindedir ama 44 tehdit listesi, topluluk raporları ve DNSBL kayıtlarından hesaplanır. AbuseIPDB'nin sayısıyla aynı çıkmaz; eşik değerinizi (ör. 75) birkaç gün gözlemleyip ayarlayın.
maxAgeInDays yanıtı değiştirmezParametre doğrulanır (1–365) ama puan her zaman güncel listelere göre hesaplanır.
verbose rapor listesi vermezcountryName eklenir; reports her zaman boş listedir. Tek tek raporları API üzerinden dağıtmıyoruz.
hostnames boşturTers DNS kaydı bu yanıtta yer almaz.
İki kategori karşılıksız13 (VPN IP) ve 17 (Spoofing) bizde yok; yalnızca bunlarla gelen rapor 422 ile reddedilir.
Yalnızca check ve reportblacklist, check-block, bulk-report ve clear-address /api/v2 altında yok. Engelleme listesi için /api/v1/feed.txt kullanın.
Ek alanlar data.ipdb altındaKaynak listeleri, ağ türü, ASN, RDAP kötüye kullanım iletişimi ve adresin herkese açık sayfası. AbuseIPDB için yazılmış bir istemci bu alana bakmaz.

Günlük sınırlar

HesapSorgu / günRapor / günÜcret
IP-DB, yeni hesap1.0001.000Ücretsiz
IP-DB, e-posta doğrulanmış10.00010.000Ücretsiz
IP-DB, katkıcı (sensör ya da Shield çalıştıran)30.00030.000Ücretsiz
AbuseIPDB, ücretsiz (Individual)1,0001,000Ücretsiz
AbuseIPDB satırı kendi fiyat ve doküman sayfalarından 16 Kasım 2026'da okunmuştur; güncel değer için oraya bakın. IP-DB'de sorgu ve rapor ayrı sayılır, /api/v1 ve /api/v2 aynı sayacı kullanır. Sınır yerel gece yarısında sıfırlanır. Daha fazlasına ihtiyacınız varsa yazın; ücretsiz yükseltiyoruz.

Bir dakikada başlayın

Hesap açın, e-postanızı doğrulayın, panelden anahtar üretin. Kendi API'mizin tüm alanları ve engelleme listesi beslemesi için dokümana bakın.

Ücretsiz anahtar al API dokümanı Entegrasyon rehberleri

Sık Sorulan Sorular

AbuseIPDB anahtarımla çalışır mı?
Hayır. Anahtarlar hizmete özeldir; IP-DB anahtarı ücretsiz hesap panelinden alınır ve Key başlığında aynı şekilde gönderilir.
Puanlar AbuseIPDB ile aynı mı çıkar?
Hayır. Ölçek aynıdır (0–100) ama hesap farklıdır: IP-DB puanı 44 tehdit listesi, topluluk raporları ve DNSBL kayıtlarından üretilir. Eşiğinizi birkaç gün izleyip ayarlamanızı öneririz.
İkisini birlikte kullanabilir miyim?
Evet. fail2ban bir jail'de birden fazla eylem çalıştırabilir, betikler iki kaynağı da sorgulayabilir. Bir kaynağın sınırına takıldığınızda diğeri çalışmaya devam eder.
Ücretli mi?
Hayır. IP-DB kamu yararına çalışan ücretsiz bir hizmettir ve ücretli planı yoktur. Doğrulanmış hesap günde 10.000 sorgu alır; daha fazlası istek üzerine ücretsiz açılır.
/api/v1 ile /api/v2 ayrı kota mı kullanır?
Hayır, aynı günlük sayacı kullanırlar. Raporlar ise sorgulardan ayrı sayılır; bildirim göndermek sorgu hakkınızı azaltmaz.

AbuseIPDB, sahibinin ticari markasıdır. IP-DB bağımsız bir hizmettir; AbuseIPDB ile bir bağı ya da ortaklığı yoktur.