> ## 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.
# Ottieni un profilo di code scan (API Devin)
> Recupera un singolo profilo di code scan di Devin, inclusi modalità, tipo di scansione, glob di inclusione/esclusione e istruzioni, 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 metadati del profilo, la visibilità (di proprietà dell'organizzazione o condiviso a livello di account), i glob di inclusione/esclusione e tutti i relativi campi di istruzioni (per indagine, comunicazione e sorgente di ingestione). Per trovare gli ID dei profili, consulta [Elenca i profili di Code Scan](/it/api-reference/v3/code-scans/organizations-code-scans-profiles).
Restituisce `404` se il profilo non esiste o non è visibile all'organizzazione.
## OpenAPI
````yaml it/v3-openapi.yaml GET /v3/organizations/{org_id}/code-scans/profiles/{profile_id}
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/profiles/{profile_id}:
get:
tags:
- code-scans
summary: Ottenere il profilo di code scan
description: >-
Recupera un profilo di code scan in base all'ID.
Restituisce i metadati del profilo, la visibilità (di proprietà dell'org
o condiviso a livello di account) e tutti i suoi campi di linee guida.
Restituisce ``404`` se il profilo non esiste o non è visibile
all'organizzazione.
operationId: >-
handle_get_code_scan_profile_v3_organizations__org_id__code_scans_profiles__profile_id__get
parameters:
- in: path
name: profile_id
required: true
schema:
title: Profile Id
type: string
- description: 'ID dell''organizzazione (prefisso: org-)'
in: path
name: org_id
required: true
schema:
example: org-abc123def456
title: Org Id
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/CodeScanProfileDetailResponse'
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:
CodeScanProfileDetailResponse:
description: >-
Dettagli completi di un profilo di code scan, incluse le relative linee
guida.
properties:
communication_guidance:
anyOf:
- type: string
- type: 'null'
description: >-
Indicazioni per la fase di comunicazione (azioni sui risultati
finali, ad es. notifica ai responsabili o agli stakeholder), se
presenti.
title: Communication Guidance
created_at:
description: Data di creazione del profilo (secondi Unix).
title: Created At
type: integer
description:
anyOf:
- type: string
- type: 'null'
description: Descrizione del profilo, se presente.
title: Description
exclude_globs:
anyOf:
- items:
type: string
type: array
- type: 'null'
description: Pattern glob dei file da escludere dalla scansione, se presenti.
title: Exclude Globs
include_globs:
anyOf:
- items:
type: string
type: array
- type: 'null'
description: Pattern glob dei file da includere nella scansione, se presenti.
title: Include Globs
ingestion_source_guidance:
anyOf:
- type: string
- type: 'null'
description: Linee guida che descrivono la sorgente di ingestione, se presenti.
title: Ingestion Source Guidance
investigation_guidance:
anyOf:
- type: string
- type: 'null'
description: Linee guida per la fase di indagine, se presenti.
title: Investigation Guidance
mode:
description: 'Modalità del profilo: discover o ingest.'
enum:
- discover
- ingest
title: Mode
type: string
name:
description: Nome del profilo.
title: Name
type: string
org_id:
anyOf:
- type: string
- type: 'null'
description: >-
Organizzazione proprietaria del profilo. Null quando il profilo è
condiviso a livello di account.
title: Org Id
post_ingestion_guidance:
anyOf:
- type: string
- type: 'null'
description: Linee guida per la fase successiva all'ingestione, se presenti.
title: Post Ingestion Guidance
profile_id:
description: Identificatore univoco del profilo.
title: Profile Id
type: string
remediation_guidance:
anyOf:
- type: string
- type: 'null'
description: Linee guida per la fase di risoluzione, se presenti.
title: Remediation Guidance
report_guidance:
anyOf:
- type: string
- type: 'null'
description: Linee guida per la fase di report, se presenti.
title: Report Guidance
scan_type:
description: Tipo di scansione configurato dal profilo.
enum:
- security
- performance
- db-queries
- test-coverage
- dead-code
- code-quality
- telemetry
- accessibility
- general
- migration-docs
title: Scan Type
type: string
threat_model_guidance:
anyOf:
- type: string
- type: 'null'
description: Indicazioni che descrivono il modello di minaccia, se presente.
title: Threat Model Guidance
triage_guidance:
anyOf:
- type: string
- type: 'null'
description: Indicazioni per la fase di triage, se presenti.
title: Triage Guidance
validation_guidance:
anyOf:
- type: string
- type: 'null'
description: Indicazioni per la fase di validazione, se presenti.
title: Validation Guidance
visibility:
description: >-
Indica se il profilo appartiene a una singola organizzazione o è
condiviso a livello di account.
enum:
- org
- account
title: Visibility
type: string
required:
- profile_id
- name
- description
- visibility
- org_id
- scan_type
- mode
- include_globs
- exclude_globs
- threat_model_guidance
- investigation_guidance
- triage_guidance
- validation_guidance
- report_guidance
- remediation_guidance
- ingestion_source_guidance
- post_ingestion_guidance
- created_at
title: CodeScanProfileDetailResponse
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
securitySchemes:
bearerAuth:
description: 'Credenziale dell''utente del servizio (prefisso: cog_)'
scheme: bearer
type: http
````