> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Elencare le code scan (API Devin)
> Elenca le code scan di Devin in un'organizzazione e monitora lo stato delle scansioni, con filtri per intervallo temporale e repository, tramite l'API v3 dell'organizzazione
## Autorizzazioni
Richiede un [utente di servizio](/it/api-reference/v3/service-users/members-service-users) o un [token di accesso personale](/it/api-reference/personal-access-tokens) con l'autorizzazione `ViewCodeScans` a livello dell'organizzazione.
## Comportamento
Restituisce i code scan dell'organizzazione, dal più recente al meno recente. Usalo per verificare periodicamente lo `status` di una scansione avviata con [Avvia Code Scan](/it/api-reference/v3/code-scans/organizations-code-scans-start): `waiting` → `pending` → `running` → `completed` (oppure `failed` / `cancelled`). `awaiting_user_input` si applica solo alle scansioni interattive avviate dalla web app; le scansioni avviate tramite API non raggiungono questo stato. Per elencare le scansioni di tutte le organizzazioni in un Enterprise, usa [Elenca Code Scan (Enterprise)](/it/api-reference/v3/code-scans/enterprise-code-scans-list).
### Filtri
* `time_after` / `time_before`: timestamp Unix in secondi (UTC) che delimitano l'istante di creazione della scansione.
* `repo_name`: solo le scansioni che hanno analizzato questo repository. Include anche le scansioni multi-repo che lo comprendono.
I risultati sono paginati tramite un cursore opaco (`after` / `first`).
## OpenAPI
````yaml it/v3-openapi.yaml GET /v3/organizations/{org_id}/code-scans/scans
openapi: 3.1.0
info:
description: API Devin v3 con autenticazione utente di servizio e RBAC
title: Devin API v3
version: 3.0.0
servers: []
security:
- bearerAuth: []
paths:
/v3/organizations/{org_id}/code-scans/scans:
get:
tags:
- code-scans
summary: Elencare i code scan
description: >-
Elencare i code scan dell'organizzazione.
Le scansioni vengono restituite in ordine dalla più recente alla meno
recente. Facoltativamente, filtra per ``repo_name`` e per orario di
creazione (``time_after`` / ``time_before``); i risultati sono paginati
con un cursore opaco (``after`` / ``first``).
operationId: handle_list_code_scans_v3_organizations__org_id__code_scans_scans_get
parameters:
- description: 'ID dell''organizzazione (prefisso: org-)'
in: path
name: org_id
required: true
schema:
example: org-abc123def456
title: Org Id
type: string
- in: query
name: time_before
required: false
schema:
anyOf:
- type: integer
- type: 'null'
title: Time Before
- in: query
name: time_after
required: false
schema:
anyOf:
- type: integer
- type: 'null'
title: Time After
- in: query
name: after
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: After
- in: query
name: first
required: false
schema:
default: 100
maximum: 200
minimum: 1
title: First
type: integer
- description: >-
Filtra le scansioni che hanno analizzato questo repository. Include
le scansioni multi-repo anche quando il repository non è la repo
primaria della scansione, quindi gli elementi restituiti potrebbero
riportare un valore ``repo_name`` diverso.
in: query
name: repo_name
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: >-
Filtra le scansioni che hanno analizzato questo repository.
Include le scansioni multi-repo anche quando il repository non è
la repo primaria della scansione, quindi gli elementi restituiti
potrebbero riportare un valore ``repo_name`` diverso.
title: Repo Name
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/PaginatedResponse_CodeScanResponse_'
description: Risposta riuscita
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Non autorizzato
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Accesso negato
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Non trovato
'409':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Conflitto
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Contenuto non elaborabile
'429':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Troppe richieste
components:
schemas:
PaginatedResponse_CodeScanResponse_:
properties:
end_cursor:
anyOf:
- type: string
- type: 'null'
description: >-
Cursor per recuperare la pagina successiva, oppure None se questa è
l'ultima pagina.
title: End Cursor
has_next_page:
default: false
description: Indica se sono disponibili altri elementi dopo questa pagina.
title: Has Next Page
type: boolean
items:
items:
$ref: '#/components/schemas/CodeScanResponse'
title: Items
type: array
total:
anyOf:
- type: integer
- type: 'null'
description: >-
Conteggio totale facoltativo (può essere omesso per motivi di
prestazioni).
title: Total
required:
- items
title: PaginatedResponse[CodeScanResponse]
type: object
ProblemDetail:
description: >-
Corpo dell'errore application/problem+json RFC 9457 per l'API v3.
detail è mantenuto dal corpo legacy {"detail": ...} per
retrocompatibilità; gli
altri membri sono aggiuntivi. errors contiene gli errori di validazione
a livello di campo
(solo 422).
properties:
detail:
anyOf:
- type: string
- type: 'null'
description: >-
Una spiegazione leggibile dall'utente, specifica per questa
occorrenza.
title: Detail
errors:
anyOf:
- items:
additionalProperties: true
type: object
type: array
- type: 'null'
description: Errori di convalida a livello di campo (solo per le risposte 422).
title: Errors
instance:
anyOf:
- type: string
- type: 'null'
description: >-
Un riferimento URI (il percorso della richiesta) per questa
occorrenza.
title: Instance
status:
description: Il codice di stato HTTP.
title: Status
type: integer
title:
description: Un breve riepilogo del tipo di problema, leggibile dall'utente.
title: Title
type: string
type:
default: about:blank
description: Un riferimento URI che identifica il tipo di problema.
title: Type
type: string
required:
- title
- status
title: ProblemDetail
type: object
CodeScanResponse:
description: Un singolo code scan.
properties:
created_at:
description: Momento in cui lo scan è stato creato (secondi Unix).
title: Created At
type: integer
host:
anyOf:
- type: string
- type: 'null'
description: Host Git della repository, se noto.
title: Host
org_id:
description: Organizzazione a cui appartiene lo scan.
title: Org Id
type: string
profile:
anyOf:
- $ref: '#/components/schemas/CodeScanProfileResponse'
- type: 'null'
description: Profilo con cui è stato eseguito lo scan, se presente.
repo_name:
description: >-
Repository principale dello scan. Gli scan multi-repo coprono
repository aggiuntive non elencate qui.
title: Repo Name
type: string
scan_id:
description: Identificatore univoco dello scan.
title: Scan Id
type: string
scan_type:
description: Tipo di scansione, definito al momento della creazione.
enum:
- security
- performance
- db-queries
- test-coverage
- dead-code
- code-quality
- telemetry
- accessibility
- general
- migration-docs
title: Scan Type
type: string
status:
description: >-
Stato dello scan: waiting, pending, running, awaiting_user_input,
completed, failed o cancelled.
enum:
- waiting
- pending
- running
- awaiting_user_input
- completed
- failed
- cancelled
title: Status
type: string
required:
- scan_id
- org_id
- repo_name
- host
- status
- profile
- scan_type
- created_at
title: CodeScanResponse
type: object
CodeScanProfileResponse:
description: Riepilogo del profilo con cui è stato eseguito un scan.
properties:
name:
description: Nome del profilo.
title: Name
type: string
profile_id:
description: Identificatore univoco del profilo.
title: Profile Id
type: string
required:
- profile_id
- name
title: CodeScanProfileResponse
type: object
securitySchemes:
bearerAuth:
description: 'Credenziale dell''utente del servizio (prefisso: cog_)'
scheme: bearer
type: http
````