Skip to main content
GET
Listar varreduras de código

Permissões

Requer um usuário de serviço ou um token de acesso pessoal com a permissão ViewCodeScans no nível da organização.

Comportamento

Retorna as varreduras de código da organização, da mais recente para a mais antiga. Use este endpoint para consultar o status de uma varredura iniciada com Iniciar varredura de código: waitingpendingrunningcompleted (ou failed / cancelled). awaiting_user_input se aplica apenas a varreduras interativas iniciadas no app web; varreduras iniciadas pela API não entram nesse estado. Para listar varreduras em todas as organizações de uma Enterprise, use Listar varreduras de código (Enterprise).

Filtros

  • time_after / time_before: timestamps Unix em segundos (UTC) que delimitam o horário de criação da varredura.
  • repo_name: apenas varreduras que analisaram este repositório. Inclui varreduras de vários repositórios que o contenham.
Os resultados são paginados com um cursor opaco (after / first).

Autorizações

Authorization
string
header
obrigatório

Credencial de usuário de serviço (prefixo: cog_)

Parâmetros de caminho

org_id
string
obrigatório

ID da organização (prefixo: org-)

Exemplo:

"org-abc123def456"

Parâmetros de consulta

time_before
integer | null
time_after
integer | null
after
string | null
first
integer
padrão:100
Intervalo obrigatório: 1 <= x <= 200
repo_name
string | null

Filtre para varreduras que analisaram este repositório. Inclui varreduras de vários repositórios mesmo quando o repositório não é o principal da varredura, portanto os itens retornados podem informar um repo_name diferente.

Resposta

Resposta bem-sucedida

items
CodeScanResponse · object[]
obrigatório
end_cursor
string | null

Cursor para buscar a próxima página, ou None se esta for a última página.

has_next_page
boolean
padrão:false

Indica se há mais itens disponíveis após esta página.

total
integer | null

Contagem total opcional (pode ser omitida por desempenho).