API Справочник

VisitorFilters предоставя RESTful API за програмен достъп до вашия акаунт, сайтове, правила и данни за посетители. Всички API заявки изискват удостоверяване чрез API токени.

Удостоверяване

Включете вашия API токен в заглавката Authorization:

Authorization: Bearer YOUR_API_TOKEN

Генерирайте API токени от Настройки → API Токени в таблото за управление.

Базов URL

https://visitorfilters.com/api/v1

Крайни точки

Сайтове

Метод	Крайна точка	Описание
`GET`	`/sites`	Списък на всички сайтове
`GET`	`/sites/{id}`	Подробности за сайт
`POST`	`/sites`	Създаване на нов сайт
`PUT`	`/sites/{id}`	Актуализиране на настройките на сайт

Правила

Метод	Крайна точка	Описание
`GET`	`/sites/{id}/rules`	Списък на правилата за сайт
`POST`	`/sites/{id}/rules`	Създаване на правило
`PUT`	`/rules/{id}`	Актуализиране на правило
`DELETE`	`/rules/{id}`	Изтриване на правило

Посетители и събития

Метод	Крайна точка	Описание
`GET`	`/sites/{id}/visitors`	Списък на посетителите (с странициране)
`GET`	`/sites/{id}/events`	Списък на последните събития
`GET`	`/visitors/{id}`	Подробности за посетител с рисков резултат

Забрани

Метод	Крайна точка	Описание
`GET`	`/sites/{id}/bans`	Списък на активните забрани
`POST`	`/sites/{id}/bans`	Създаване на забрана
`DELETE`	`/bans/{id}`	Премахване на забрана

Ограничения на скоростта

API заявките са ограничени по скорост на токен:

Стандартни планове: 60 заявки/минута
Pro планове: 120 заявки/минута
Enterprise: Персонализирани лимити

Заглавките за ограничение на скоростта са включени в всеки отговор:

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

Отговори при грешки

Всички грешки връщат последователна JSON структура:

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