Avvia Code Scan (Devin API)
Avvia un nuovo code scan di Devin su un repository tramite l’API v3 dell’organizzazione, facoltativamente con un profilo di scansione o l’SHA di un commit
Autorizzazioni
UseCodeScans a livello dell’organizzazione.
Comportamento
repo_name nell’organizzazione. Il code scan viene avviato in modo asincrono dal dispatcher delle scansioni; la risposta contiene il record del code scan con status iniziale waiting o pending. Interroga Elenca Code Scan per monitorarne l’avanzamento e Elenca risultati di Code Scan (filtrati per scan_id) per consultare i risultati quando il code scan raggiunge lo stato completed.
Il code scan è attribuito al principal chiamante (l’utente di servizio o il PAT che ha effettuato la richiesta). L’equivalente nell’ambito Enterprise è Avvia Code Scan (Enterprise).
Campi della richiesta
repo_name(obbligatorio): nome completo del repository, ad es.owner/repo. Il repository deve essere già accessibile tramite l’integrazione Git dell’organizzazione.host: host Git del repository, se non può essere dedotto.profile_id: un profilo di scansione da applicare. Per i profili in modalitàingest, utilizza Avvia scansione di ingestione.scan_type: tipo di scansione da eseguire. Se viene specificatoprofile_id, deve corrispondere al tipo di scansione del profilo. Per impostazione predefinita, viene usato il tipo del profilo oppuresecurityper le scansioni senza profilo. I tipi di scansione diversi dasecurityrichiedono un profilo.commit_sha: commit da estrarre prima della scansione. Per impostazione predefinita, viene usato l’HEAD del branch predefinito del repository.
Errori
400sescan_typeè in conflitto con il profilo o se viene specificato unscan_typenon di sicurezza senza un profilo.403se l’organizzazione è limitata alle sole scansioni di ingestione e non viene specificato un profilo in modalitàingest.404se il repository o il profilo non è visibile all’organizzazione.409se il backlog delle scansioni dell’organizzazione ha raggiunto il limite. Riprova più tardi.
Autorizzazioni
Credenziale dell'utente del servizio (prefisso: cog_)
Parametri del percorso
ID dell'organizzazione (prefisso: org-)
"org-abc123def456"
Corpo
Corpo della richiesta per avviare un nuovo code scan.
Nome completo del repository da sottoporre a scansione.
Commit da estrarre prima della scansione.
Host Git del repository, se noto.
Profilo di scansione da applicare alla scansione.
Tipo di scansione da eseguire. Deve corrispondere al tipo di scansione del profilo quando viene fornito un profilo; per impostazione predefinita usa il tipo del profilo oppure 'security' per le scansioni senza profilo. I tipi diversi da security richiedono un profilo e vengono rifiutati senza di esso.
security, performance, db-queries, test-coverage, dead-code, code-quality, telemetry, accessibility, general, migration-docs Risposta
Risposta con esito positivo
Un singolo code scan.
Momento in cui lo scan è stato creato (secondi Unix).
Host Git della repository, se noto.
Organizzazione a cui appartiene lo scan.
Profilo con cui è stato eseguito lo scan, se presente.
Repository principale dello scan. Gli scan multi-repo coprono repository aggiuntive non elencate qui.
Identificatore univoco dello scan.
Tipo di scansione, definito al momento della creazione.
security, performance, db-queries, test-coverage, dead-code, code-quality, telemetry, accessibility, general, migration-docs Stato dello scan: waiting, pending, running, awaiting_user_input, completed, failed o cancelled.
waiting, pending, running, awaiting_user_input, completed, failed, cancelled 
