Cómo usar la API de Vexday: clave gratis y primera consulta de CVE
Genera la clave gratis, consulta una CVE en JSON con la severidad, la explotación activa y la nota de riesgo, y sigue el límite de la cuenta. Para llevar el dato de Vexday a tu sistema.
Lo que necesitas
- Una cuenta de Vexday: basta el correo, sin contraseña ni tarjeta.
- Una terminal con curl o cualquier cliente HTTP.
Límites de la cuenta: gratis, 50 por día y 10 por minuto · SOC, 5000 por día y 60 por minuto · MSSP, 20.000 por día y 120 por minuto.
Paso a paso
Crea la clave
En el panel, abre Integraciones y haz clic en Nueva clave. Ponle un nombre, como el del sistema que la va a usar, y copia la clave en el momento: empieza con vx_live_ y solo aparece una vez.
Haz la primera consulta
Pide el detalle de una CVE con la clave en el encabezado Authorization. El parámetro lang elige el idioma de los campos traducidos: pt, es o en.
curl -s -H "Authorization: Bearer vx_live_SUA_CHAVE" \ "https://api.vexday.io/api/v1/cve/CVE-2024-3400?lang=es"
Lee la respuesta
El registro viene en data: la severidad (cvss_score), la probabilidad de explotación (epss_score), la explotación activa (in_kev), la prueba de concepto pública (has_public_poc) y la nota de riesgo de Vexday (risk). El campo attribution trae el crédito de las fuentes: mantenlo al mostrar el dato.
Busca lo que te importa
La búsqueda filtra por fabricante, producto, severidad, explotación activa y prueba de concepto pública, y viene ordenada por riesgo. El recorte /kev trae solo lo que está bajo explotación activa.
curl -s -H "Authorization: Bearer vx_live_SUA_CHAVE" \ "https://api.vexday.io/api/v1/cve?vendor=fortinet&in_kev=true&page_size=20"
Sigue el consumo
El /status muestra el plan, las consultas del día y cuántas quedan. El límite es de la cuenta, sumando las claves; al superarlo, la API responde 429 con el encabezado Retry-After.
curl -s -H "Authorization: Bearer vx_live_SUA_CHAVE" "https://api.vexday.io/api/v1/status"