> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Ottieni le metriche delle code scan (API Devin)
> Ottieni tramite l'API v3 le metriche aggregate di Devin relative a code scan, finding e pull request di correzione per una singola organizzazione in un intervallo di tempo
## 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.
## Filtri temporali
Questo endpoint richiede i parametri di query `time_after` e `time_before`.
* Sia `time_after` sia `time_before` sono **timestamp Unix espressi in secondi**, interpretati in UTC.
* `time_after` deve essere precedente a `time_before`.
* L'intervallo tra `time_after` e `time_before` deve essere **pari o inferiore a 100 giorni**.
* Le metriche sono relative ai code scan creati nell'ambito di questo intervallo di tempo.
Per le metriche di tutte le organizzazioni di un Enterprise, usa [Ottieni le metriche delle code scan (Enterprise)](/it/api-reference/v3/code-scans/enterprise-code-scans-metrics).
## OpenAPI
````yaml it/v3-openapi.yaml GET /v3/organizations/{org_id}/code-scans/metrics
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/metrics:
get:
tags:
- code-scans
summary: Ottenere le metriche del code scan
description: >-
Ottieni le metriche aggregate dei code scan per l'organizzazione.
Restituisce metriche di scan, finding e PR di remediation per i code
scan creati
nell'intervallo di tempo specificato.
operationId: >-
handle_get_code_scan_metrics_v3_organizations__org_id__code_scans_metrics_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: true
schema:
title: Time Before
type: integer
- in: query
name: time_after
required: true
schema:
title: Time After
type: integer
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/CodeScanMetricsResponse'
description: Risposta corretta
'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:
CodeScanMetricsResponse:
description: >-
Modello di risposta per le metriche delle scansioni del codice.
Tutte le metriche sono limitate alle scansioni del codice create
nell'intervallo di tempo specificato: i finding e le PR di remediation
sono attribuiti alla scansione che li ha prodotti.
properties:
avg_pr_open_duration_seconds:
anyOf:
- type: number
- type: 'null'
description: >-
Tempo medio per cui una PR è (o è stata) aperta, in secondi: dalla
creazione al merge o alla chiusura per le PR concluse, dalla
creazione a oggi per le PR aperte. Null se non è stata creata alcuna
PR.
title: Avg Pr Open Duration Seconds
avg_pr_time_to_merge_seconds:
anyOf:
- type: number
- type: 'null'
description: >-
Tempo medio dalla creazione della PR al merge, in secondi. Null se
non è stata unita alcuna PR.
title: Avg Pr Time To Merge Seconds
open_critical_findings_count:
description: Numero di finding aperti con gravità critical.
title: Open Critical Findings Count
type: integer
open_high_findings_count:
description: Numero di finding aperti con gravità high.
title: Open High Findings Count
type: integer
open_low_findings_count:
description: Numero di finding aperti con gravità low.
title: Open Low Findings Count
type: integer
open_medium_findings_count:
description: Numero di finding aperti con gravità medium.
title: Open Medium Findings Count
type: integer
prs_closed_count:
description: Numero di PR di remediation chiuse senza essere unite.
title: Prs Closed Count
type: integer
prs_created_count:
description: Numero di PR create dalle sessioni di remediation delle scansioni.
title: Prs Created Count
type: integer
prs_merged_count:
description: Numero di PR di remediation unite.
title: Prs Merged Count
type: integer
prs_open_count:
description: Numero di PR di remediation attualmente aperte.
title: Prs Open Count
type: integer
repos_scanned_count:
description: Numero di repository distinti sottoposti a scansione.
title: Repos Scanned Count
type: integer
scans_count:
description: >-
Numero di scansioni del codice create nell'intervallo di tempo
specificato.
title: Scans Count
type: integer
required:
- scans_count
- repos_scanned_count
- prs_created_count
- prs_open_count
- prs_merged_count
- prs_closed_count
- avg_pr_time_to_merge_seconds
- avg_pr_open_duration_seconds
- open_critical_findings_count
- open_high_findings_count
- open_medium_findings_count
- open_low_findings_count
title: CodeScanMetricsResponse
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
````