Integraciones

Comprobaciones en el edge

Una llamada por visitante desde tu edge, y la política que aplica tu Worker.

Comprobar un visitante

POST/v1/edge/check

Clave de APICuenta como 2 solicitudes

Parámetros

ipstringObligatorio
IP del cliente vista en tu edge.
sitestring
El id de tu sitio, desde el panel. Sin él, la respuesta no incluye sitio.
user_agentstring
Cabecera User-Agent de la solicitud.
ja4string
Huella TLS JA4 del cliente.
headersobject
Cabeceras de la solicitud, para la comprobación de coherencia.
headless_flagsobject
Indicios de automatización recogidos en el navegador, como webdriver.
request_idstring
Tu propio id para la solicitud, guardado con el veredicto.

Campos de la respuesta

classstring
verified_bot, malicious_automation, ai_agent, tor, vpn, proxy, relay, hosting o human.
agentobject
El veredicto de Agentscan: clase, confianza, acción y señales.
networkobject
networkClass, anonymized, riskScore, provider, vpnProvider, country, asn, asnName y evidence. provider y vpnProvider desde Starter, null en Free.
network.vpnProviderstring | null
Servicio VPN de una dirección vpn (NordVPN, Mullvad...), si se conoce. Desde Starter, null en Free.
siteobject | null
Id, modo y policyVersion de tu sitio; null si el sitio no se conoce o no es tuyo.
lockedstring[]
Rutas con puntos de los campos enviados como null en este plan. Ausente desde Starter.
planRequiredstring
Plan que incluye los campos bloqueados. Ausente desde Starter.

curl -X POST https://ipscanner.io/v1/edge/check \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "site": "site_4fQ8nZ2kLm7xR1vT9cBw",
    "ip": "203.0.113.7",
    "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 Safari/605.1.15",
    "ja4": "t13d1516h2_8daaf6152771_02713d6af862",
    "request_id": "8c1f2a3b4d5e6f70-AMS"
  }'

Respuesta

{
  "class": "vpn",
  "agent": {
    "class": "human",
    "confidence": 0.6,
    "action": "allow",
    "signals": {
      "network_origin": "vpn",
      "anonymized": true,
      "headless": false
    }
  },
  "network": {
    "networkClass": "vpn",
    "anonymized": true,
    "riskScore": 90,
    "provider": "M247 Europe SRL",
    "vpnProvider": "NordVPN",
    "country": "NL",
    "asn": 9009,
    "asnName": "M247 Europe SRL",
    "evidence": [
      "vpn_server_list"
    ]
  },
  "site": {
    "id": "site_4fQ8nZ2kLm7xR1vT9cBw",
    "mode": "monitor",
    "policyVersion": 3
  }
}

Leer la política de un sitio

GET/v1/sites/{id}/policy

Clave de APINo consume cupo

Parámetros

idstringrutaObligatorio
Id del sitio, como site_4fQ8nZ2kLm7xR1vT9cBw.

Campos de la respuesta

sitestring
El id del sitio.
modestring
monitor o enforce.
policyobject
allow, flag o block por clase de tráfico. Una clase ausente equivale a allow.
versioninteger
Sube en uno cada vez que cambian la política o el modo.
updatedAtstring
Cuándo cambió el sitio por última vez.

curl https://ipscanner.io/v1/sites/site_4fQ8nZ2kLm7xR1vT9cBw/policy \
  -H "Authorization: Bearer YOUR_API_KEY"

Respuesta

{
  "site": "site_4fQ8nZ2kLm7xR1vT9cBw",
  "mode": "enforce",
  "policy": {
    "malicious_automation": "block",
    "ai_agent": "flag",
    "verified_bot": "allow"
  },
  "version": 3,
  "updatedAt": "2026-10-08T09:30:00Z"
}