Referencia de API

VisitorFilters proporciona una API RESTful para acceso programático a su cuenta, sitios, reglas y datos de visitantes. Todas las solicitudes de API requieren autenticación mediante tokens de API.

Autenticación

Incluya su token de API en la cabecera Authorization:

Authorization: Bearer YOUR_API_TOKEN

Genere tokens de API desde Configuración → Tokens de API en su panel de control.

URL Base

https://visitorfilters.com/api/v1

Endpoints

Sitios

Método	Endpoint	Descripción
`GET`	`/sites`	Listar todos los sitios
`GET`	`/sites/{id}`	Obtener detalles del sitio
`POST`	`/sites`	Crear un nuevo sitio
`PUT`	`/sites/{id}`	Actualizar configuración del sitio

Reglas

Método	Endpoint	Descripción
`GET`	`/sites/{id}/rules`	Listar reglas de un sitio
`POST`	`/sites/{id}/rules`	Crear una regla
`PUT`	`/rules/{id}`	Actualizar una regla
`DELETE`	`/rules/{id}`	Eliminar una regla

Visitantes y Eventos

Método	Endpoint	Descripción
`GET`	`/sites/{id}/visitors`	Listar visitantes (paginado)
`GET`	`/sites/{id}/events`	Listar eventos recientes
`GET`	`/visitors/{id}`	Detalle del visitante con puntuación de riesgo

Prohibiciones

Método	Endpoint	Descripción
`GET`	`/sites/{id}/bans`	Listar prohibiciones activas
`POST`	`/sites/{id}/bans`	Crear una prohibición
`DELETE`	`/bans/{id}`	Eliminar una prohibición

Límites de Velocidad

Las solicitudes de API tienen límite de velocidad por token:

Planes estándar: 60 solicitudes/minuto
Planes Pro: 120 solicitudes/minuto
Enterprise: Límites personalizados

Las cabeceras de límite de velocidad se incluyen en cada respuesta:

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

Respuestas de Error

Todos los errores devuelven una estructura JSON consistente:

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