Como saber pela API se a versão instalada é afetada por uma CVE
Use o campo affected_versions para decidir se a versão que você tem está na faixa vulnerável, e o /changes com o /cve/batch para manter a sua base em dia sem baixar tudo de novo.
O que você precisa
- A chave da API: o guia de primeiros passos mostra como gerar.
- A lista de produtos e versões que você quer conferir.
Limites da conta: grátis, 50 por dia e 10 por minuto · SOC, 5.000 por dia e 60 por minuto · MSSP, 20.000 por dia e 120 por minuto.
Passo a passo
Leia o affected_versions da CVE
Cada item traz o fabricante, o produto, a base da faixa (version), o limite superior exclusivo (less_than) ou inclusivo (less_or_equal), o status e o version_type, que diz como comparar.
curl -s -H "Authorization: Bearer vx_live_SUA_CHAVE" \ "https://api.vexday.io/api/v1/cve/CVE-2024-3400" | jq '.data.affected_versions'
Compare como versão, não como texto
Use um comparador que respeite o version_type, como o packaging.version do Python para semver. Na ordem alfabética, uma versão menor pode parecer maior; git e custom pedem tratamento próprio.
"2.4.9" > "2.4.49" # verdadeiro como texto, falso como versão
Respeite os limites e o status
O less_than não inclui o limite e o less_or_equal inclui: errar isso erra na versão da fronteira. A faixa com status unaffected é a CNA dizendo que ela não é vulnerável.
Trate a faixa vazia como falta de dado
Sem affected_versions, a CNA não publicou a versão: a CVE afeta a família do produto, e a sua versão não dá para confirmar. Mostre a lacuna em vez de concluir que não afeta.
Busque só o que mudou
O /changes lista as CVEs, os incidentes e as vítimas que mudaram desde uma data, de até 30 dias atrás. Com truncated, repita a chamada com o next_since que veio na resposta.
curl -s -H "Authorization: Bearer vx_live_SUA_CHAVE" \ "https://api.vexday.io/api/v1/changes?since=2026-11-01T00:00:00Z"
Traga o detalhe em lote
O /cve/batch devolve várias CVEs numa chamada. Cada ID conta uma consulta no limite diário, e os que não existem voltam em not_found, sem erro.
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"