API Referansı

VisitorFilters, hesabınıza, sitelerinize, kurallarınıza ve ziyaretçi verilerinize programlı erişim için RESTful bir API sağlar. Tüm API istekleri, API token'ları aracılığıyla kimlik doğrulaması gerektirir.

Kimlik Doğrulama

API token'ınızı Authorization başlığına ekleyin:

Authorization: Bearer YOUR_API_TOKEN

API token'larını kontrol panelinizde Ayarlar → API Token'ları bölümünden oluşturun.

Temel URL

https://visitorfilters.com/api/v1

Endpoint'ler

Siteler

Metot	Endpoint	Açıklama
`GET`	`/sites`	Tüm siteleri listele
`GET`	`/sites/{id}`	Site detaylarını getir
`POST`	`/sites`	Yeni site oluştur
`PUT`	`/sites/{id}`	Site ayarlarını güncelle

Kurallar

Metot	Endpoint	Açıklama
`GET`	`/sites/{id}/rules`	Siteye ait kuralları listele
`POST`	`/sites/{id}/rules`	Kural oluştur
`PUT`	`/rules/{id}`	Kural güncelle
`DELETE`	`/rules/{id}`	Kural sil

Ziyaretçiler ve Olaylar

Metot	Endpoint	Açıklama
`GET`	`/sites/{id}/visitors`	Ziyaretçileri listele (sayfalanmış)
`GET`	`/sites/{id}/events`	Son olayları listele
`GET`	`/visitors/{id}`	Risk puanıyla ziyaretçi detayı

Yasaklar

Metot	Endpoint	Açıklama
`GET`	`/sites/{id}/bans`	Aktif yasakları listele
`POST`	`/sites/{id}/bans`	Yasak oluştur
`DELETE`	`/bans/{id}`	Yasağı kaldır

Hız Sınırları

API istekleri, token başına hız sınırına tabidir:

Standart planlar: dakikada 60 istek
Pro planlar: dakikada 120 istek
Enterprise: Özel sınırlar

Hız sınırı başlıkları her yanıta dahil edilir:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1716400000

Hata Yanıtları

Tüm hatalar tutarlı bir JSON yapısı döndürür:

{
  "message": "The given data was invalid.",
  "errors": {
    "field": ["Error description"]
  }
}