> ## 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.
# Obtenir les métriques d’analyse de code (API Devin)
> Obtenir les métriques agrégées des analyses de code, des constats et des PR de remédiation de Devin pour une organisation sur une période donnée via l’API v3
## Autorisations
Nécessite un [utilisateur de service](/fr/api-reference/v3/service-users/members-service-users) ou un [jeton d’accès personnel](/fr/api-reference/personal-access-tokens) doté de l’autorisation `ViewCodeScans` au niveau de l’organisation.
## Filtres temporels
Cet endpoint requiert les paramètres de requête `time_after` et `time_before`.
* `time_after` et `time_before` sont des **horodatages Unix en secondes**, interprétés en UTC.
* `time_after` doit être antérieur à `time_before`.
* L'intervalle entre `time_after` et `time_before` doit être de **100 jours maximum**.
* Les métriques sont limitées aux analyses de code créées au cours de cet intervalle.
Pour obtenir les métriques de toutes les organisations d'une entreprise, utilisez [Obtenir les métriques d'analyse de code (Enterprise)](/fr/api-reference/v3/code-scans/enterprise-code-scans-metrics).
## OpenAPI
````yaml fr/v3-openapi.yaml GET /v3/organizations/{org_id}/code-scans/metrics
openapi: 3.1.0
info:
description: API Devin v3 avec authentification par compte de service et 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: Récupérer les métriques d’analyse de code
description: >-
Récupérer les métriques agrégées des analyses de code de l’organisation.
Renvoie des métriques sur les analyses, les constats et les PR de
remédiation pour les analyses de code créées dans l’intervalle de temps
spécifié.
operationId: >-
handle_get_code_scan_metrics_v3_organizations__org_id__code_scans_metrics_get
parameters:
- description: 'ID de l’organisation (préfixe : 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: Réponse réussie
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Non autorisé
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Interdit
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Introuvable
'409':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Conflit
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Contenu non traitable
'429':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Trop de requêtes
components:
schemas:
CodeScanMetricsResponse:
description: >-
Modèle de réponse pour les métriques d’analyse de code.
Toutes les métriques portent uniquement sur les analyses de code créées
dans l’intervalle de temps spécifié : les constats et les PR de
remédiation sont attribués à l’analyse qui les a produits.
properties:
avg_pr_open_duration_seconds:
anyOf:
- type: number
- type: 'null'
description: >-
Temps moyen pendant lequel une PR est (ou a été) ouverte, en
secondes : de sa création à sa fusion ou sa fermeture pour les PR
terminées, et de sa création à maintenant pour les PR ouvertes. Null
si aucune PR n’a été créée.
title: Avg Pr Open Duration Seconds
avg_pr_time_to_merge_seconds:
anyOf:
- type: number
- type: 'null'
description: >-
Temps moyen entre la création d’une PR et sa fusion, en secondes.
Null si aucune PR n’a été fusionnée.
title: Avg Pr Time To Merge Seconds
open_critical_findings_count:
description: Nombre de constats ouverts de gravité critique.
title: Open Critical Findings Count
type: integer
open_high_findings_count:
description: Nombre de constats ouverts de gravité élevée.
title: Open High Findings Count
type: integer
open_low_findings_count:
description: Nombre de constats ouverts de gravité faible.
title: Open Low Findings Count
type: integer
open_medium_findings_count:
description: Nombre de constats ouverts de gravité moyenne.
title: Open Medium Findings Count
type: integer
prs_closed_count:
description: Nombre de PR de remédiation fermées sans avoir été fusionnées.
title: Prs Closed Count
type: integer
prs_created_count:
description: Nombre de PR créées par les sessions de remédiation des analyses.
title: Prs Created Count
type: integer
prs_merged_count:
description: Nombre de PR de remédiation fusionnées.
title: Prs Merged Count
type: integer
prs_open_count:
description: Nombre de PR de remédiation actuellement ouvertes.
title: Prs Open Count
type: integer
repos_scanned_count:
description: Nombre de dépôts distincts analysés.
title: Repos Scanned Count
type: integer
scans_count:
description: Nombre d’analyses de code créées dans la période spécifiée.
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: "Corps d’erreur RFC 9457 application/problem+json pour l’API v3.\n\ndetail est conservé de l’ancien corps {\"detail\": ...} pour assurer la rétrocompatibilité\_; les\nautres membres sont ajoutés de manière additive. errors contient les échecs de validation\nau niveau des champs (422 uniquement)."
properties:
detail:
anyOf:
- type: string
- type: 'null'
description: Explication en langage clair, spécifique à cette occurrence.
title: Detail
errors:
anyOf:
- items:
additionalProperties: true
type: object
type: array
- type: 'null'
description: Erreurs de validation par champ (réponses 422 uniquement).
title: Errors
instance:
anyOf:
- type: string
- type: 'null'
description: Une référence d’URI (le chemin de la requête) pour cette occurrence.
title: Instance
status:
description: Le code d’état HTTP.
title: Status
type: integer
title:
description: Un bref résumé du type de problème, compréhensible par un humain.
title: Title
type: string
type:
default: about:blank
description: Une référence d’URI identifiant le type de problème.
title: Type
type: string
required:
- title
- status
title: ProblemDetail
type: object
securitySchemes:
bearerAuth:
description: "Identifiant de compte de service (préfixe\_: cog_)"
scheme: bearer
type: http
````