Como usar a API do Vexday: chave grátis e primeira consulta de CVE
Gere a chave grátis, consulte uma CVE em JSON com a gravidade, a exploração ativa e a nota de risco, e acompanhe o limite da conta. Para levar o dado do Vexday ao seu sistema.
O que você precisa
- Uma conta do Vexday: basta o e-mail, sem senha e sem cartão.
- Um terminal com curl ou qualquer cliente HTTP.
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
Crie a chave
No painel, abra Integrações e clique em Nova chave. Dê um nome, como o do sistema que vai usá-la, e copie a chave na hora: ela começa com vx_live_ e só aparece uma vez.
Faça a primeira consulta
Peça o detalhe de uma CVE com a chave no cabeçalho Authorization. O parâmetro lang escolhe o idioma dos campos traduzidos: pt, es ou en.
curl -s -H "Authorization: Bearer vx_live_SUA_CHAVE" \ "https://api.vexday.io/api/v1/cve/CVE-2024-3400?lang=pt"
Leia a resposta
O registro vem em data: a gravidade (cvss_score), a probabilidade de exploração (epss_score), a exploração ativa (in_kev), a prova de conceito pública (has_public_poc) e a nota de risco do Vexday (risk). O campo attribution traz o crédito das fontes: mantenha-o quando mostrar o dado.
Busque o que importa para você
A busca filtra por fabricante, produto, gravidade, exploração ativa e prova de conceito pública, e vem ordenada pelo risco. O recorte /kev traz só o que está sob exploração ativa.
curl -s -H "Authorization: Bearer vx_live_SUA_CHAVE" \ "https://api.vexday.io/api/v1/cve?vendor=fortinet&in_kev=true&page_size=20"
Acompanhe o consumo
O /status mostra o plano, as consultas do dia e quantas restam. O limite é da conta, somando as chaves; ao passar dele, a API responde 429 com o cabeçalho Retry-After.
curl -s -H "Authorization: Bearer vx_live_SUA_CHAVE" "https://api.vexday.io/api/v1/status"