API

Cómo saber por la API si la versión instalada está afectada por una CVE

Usa el campo affected_versions para decidir si la versión que tienes está en el rango vulnerable, y /changes con /cve/batch para mantener tu base al día sin descargar todo de nuevo.

  • Para quiénPara quien desarrolla inventario, CMDB o gestión de vulnerabilidades.
  • PlanCuenta gratis; más volumen en los planes
  • Tiempounos 20 min

Lo que necesitas

  • La clave de la API: la guía de primeros pasos muestra cómo generarla.
  • La lista de productos y versiones que quieres verificar.

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. Lee el affected_versions de la CVE

    Cada ítem trae el fabricante, el producto, la base del rango (version), el límite superior exclusivo (less_than) o inclusivo (less_or_equal), el status y el version_type, que dice cómo comparar.

    curl -s -H "Authorization: Bearer vx_live_SUA_CHAVE" \
      "https://api.vexday.io/api/v1/cve/CVE-2024-3400" | jq '.data.affected_versions'
  2. Compara como versión, no como texto

    Usa un comparador que respete el version_type, como packaging.version de Python para semver. En orden alfabético, una versión menor puede parecer mayor; git y custom piden un tratamiento propio.

    "2.4.9" > "2.4.49"   # verdadeiro como texto, falso como versão
  3. Respeta los límites y el status

    less_than no incluye el límite y less_or_equal sí: equivocarse ahí falla justo en la versión de frontera. El rango con status unaffected es la CNA diciendo que no es vulnerable.

  4. Trata el rango vacío como falta de dato

    Sin affected_versions, la CNA no publicó la versión: la CVE afecta a la familia del producto, y tu versión no se puede confirmar. Muestra la laguna en lugar de concluir que no afecta.

  5. Busca solo lo que cambió

    /changes lista las CVE, los incidentes y las víctimas que cambiaron desde una fecha, de hasta 30 días atrás. Con truncated, repite la llamada con el next_since que vino en la respuesta.

    curl -s -H "Authorization: Bearer vx_live_SUA_CHAVE" \
      "https://api.vexday.io/api/v1/changes?since=2026-11-01T00:00:00Z"
  6. Trae el detalle en lote

    /cve/batch devuelve varias CVE en una llamada. Cada ID cuenta una consulta en el límite diario, y los que no existen vuelven en not_found, sin error.

    curl -s -X POST -H "Authorization: Bearer vx_live_SUA_CHAVE" -H "Content-Type: application/json" \
      -d '{"ids": ["CVE-2024-3400", "CVE-2021-44228"]}' "https://api.vexday.io/api/v1/cve/batch"

¿Algo salió mal?

El affected_versions vino vacíoLa CNA no publicó el rango de versión. Muéstralo como "afecta a la familia; versión no confirmable" y síguelo con /changes: el rango puede llegar después.
/changes rechazó la fechaUsa ISO-8601 con el huso (la Z de UTC, por ejemplo) y una fecha de hasta 30 días atrás.
El lote superó el límiteCada plan tiene un número de ID por lote, y cada ID cuenta en el límite diario. Divide la lista en lotes más pequeños.

Preguntas frecuentes

¿Vexday decide por mí si mi versión es vulnerable?

En la API, no: entrega el rango del registro, y la comparación es de tu sistema. En el panel, el inventario hace esa cuenta, y la alerta puede filtrar por versión.

¿De dónde viene el rango de versión?

Del registro oficial de la CVE, publicado por la CNA, la organización que asigna el ID. El version_type dice cómo comparar.

¿Cuántos ID caben en un /cve/batch?

El número de ID por lote depende del plan y aparece en la página de precios.

Sigue