API

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.

  • Para quiénPara desarrolladores, SOC y quien integra Vexday a un sistema propio.
  • PlanCuenta gratis; más volumen en los planes
  • Tiempounos 10 min

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

  1. 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.

  2. 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"
  3. 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.

  4. 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"
  5. 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"

¿Algo salió mal?

401: clave ausente o no válidaRevisa que el encabezado esté como Authorization: Bearer vx_live_… y que la clave no haya sido revocada en Integraciones.
404 en la consulta de la CVEEl ID está mal escrito o la CVE todavía no está en la base. El formato es CVE, el año y el número, separados por guiones.
429: límite alcanzadoEspera el tiempo del Retry-After. Para más volumen, los planes SOC y MSSP aumentan el límite diario y el por minuto.

Preguntas frecuentes

¿La clave es gratis de verdad?

Sí. La cuenta gratis ya genera la clave, con un límite diario menor. Los planes de pago aumentan el volumen.

¿Existe la especificación OpenAPI?

Sí, en https://api.vexday.io/openapi.json. La documentación interactiva, para probar cada endpoint en el navegador, está en https://api.vexday.io/docs.

¿Cómo sincronizo los cambios sin descargar todo de nuevo?

Con /changes: lista lo que cambió desde una fecha. Después, /cve/batch trae el detalle de varias CVE en una llamada.

Sigue