API-Referenz

VisitorFilters stellt eine RESTful API für den programmatischen Zugriff auf Ihr Konto, Websites, Regeln und Besucherdaten bereit. Alle API-Anfragen erfordern eine Authentifizierung über API-Tokens.

Authentifizierung

Fügen Sie Ihr API-Token in den Authorization-Header ein:

Authorization: Bearer YOUR_API_TOKEN

Generieren Sie API-Tokens unter Einstellungen → API-Tokens in Ihrem Dashboard.

Basis-URL

https://visitorfilters.com/api/v1

Endpunkte

Websites

Methode	Endpunkt	Beschreibung
`GET`	`/sites`	Alle Websites auflisten
`GET`	`/sites/{id}`	Website-Details abrufen
`POST`	`/sites`	Neue Website erstellen
`PUT`	`/sites/{id}`	Website-Einstellungen aktualisieren

Regeln

Methode	Endpunkt	Beschreibung
`GET`	`/sites/{id}/rules`	Regeln für eine Website auflisten
`POST`	`/sites/{id}/rules`	Regel erstellen
`PUT`	`/rules/{id}`	Regel aktualisieren
`DELETE`	`/rules/{id}`	Regel löschen

Besucher & Ereignisse

Methode	Endpunkt	Beschreibung
`GET`	`/sites/{id}/visitors`	Besucher auflisten (paginiert)
`GET`	`/sites/{id}/events`	Aktuelle Ereignisse auflisten
`GET`	`/visitors/{id}`	Besucherdetails mit Risikobewertung

Sperren

Methode	Endpunkt	Beschreibung
`GET`	`/sites/{id}/bans`	Aktive Sperren auflisten
`POST`	`/sites/{id}/bans`	Sperre erstellen
`DELETE`	`/bans/{id}`	Sperre aufheben

Rate-Limits

API-Anfragen sind pro Token ratenbegrenzt:

Standardpläne: 60 Anfragen/Minute
Pro-Pläne: 120 Anfragen/Minute
Enterprise: Benutzerdefinierte Limits

Rate-Limit-Header sind in jeder Antwort enthalten:

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

Fehlerantworten

Alle Fehler geben eine einheitliche JSON-Struktur zurück:

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