Primeiros passos

Instale o Studio, crie um projeto e importe sua primeira API.

O Studio é um app desktop, não um scanner hospedado: tudo nesta seção roda na sua máquina, contra APIs que você mesmo possui, sem necessidade de conta.

Instalar e abrir

Baixe o instalador para o seu sistema na página do Studio e execute. Na primeira abertura você cai na tela Project — o app ainda não tem nada aberto, e nada saiu da sua máquina.

A barra lateral é agrupada da mesma forma que este guia:

  • Core — Project, Endpoints, Sitemap, Findings, Coverage
  • Traffic — Proxy, WebSocket, Repeater, Comparer, Decoder, Sequencer, Intruder
  • Auth & scope — Auth profiles, Role diff, Environments, Match & replace, Login macros
  • More — Checklist, Extender, Settings, AI coach

Criar seu primeiro projeto

Um projeto do Studio é um único arquivo SQLite local — endpoints, tráfego capturado, findings, auth profiles e tudo mais que você construir fica nesse arquivo, junto dos seus outros projetos no disco.

  1. Abra a tela Project.
  2. Dê um nome ao projeto e informe a URL base da API (por exemplo https://api.meuapp.dev).
  3. Escolha onde salvar o arquivo do projeto. O Studio sugere um nome de arquivo derivado do nome do projeto.
  4. Para voltar depois, use Open project e selecione o mesmo arquivo .sqlite — tudo que você capturou continua lá.

Não há etapa de login aqui. Contas só entram em jogo para o coach de IA, que é opcional.

Trazer sua API

Com um projeto aberto, vá em Endpoints e importe o que você já tem. O Studio mescla cada importação em um único inventário — pares método + path são deduplicados, então dá para combinar uma spec OpenAPI, uma coleção Postman e uma captura HAR no mesmo projeto sem que uma sobrescreva a outra:

  • OpenAPI 3 (JSON ou YAML)
  • Swagger 2.0 (conversão best-effort)
  • Coleção Postman (export .json)
  • HAR (.har, da aba de rede do DevTools do navegador ou de outro proxy)
  • GraphQL — aponte o Studio para um endpoint com introspecção habilitada e ele monta um inventário a partir do schema
  • Docker Compose — lê um docker-compose.yml e lista os serviços HTTP encontrados, para você semear um projeto direto de uma stack de dev local

Não tem uma spec de API à mão? Ative o proxy e gere tráfego pelo app ou navegador — toda requisição que o proxy vê é capturada do mesmo jeito que uma importação seria.

Fazer uma primeira passada

Com endpoints importados, abra Findings e rode um quick scan: o Studio busca cada endpoint documentado uma vez, captura a troca e roda o conjunto padrão de regras passivas sobre as respostas — sem proxy, sem clicar manualmente em nada. É a forma mais rápida de ver se uma spec está corretamente conectada e obter uma primeira lista de findings.

A partir daí:

  • Scanning & findings — como ler a lista de findings, a coverage matrix e as regras de escopo.
  • Traffic capture — interceptar tráfego real em vez de reproduzir uma spec.
  • Auth, scope & BOLA — testar endpoints como um usuário autenticado, e comparar papéis entre si.