> ## 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.
# Code-Scan-Metriken abrufen (Devin API)
> Aggregierte Metriken zu Devin-Code-Scans, Findings und PRs zur Fehlerbehebung für eine einzelne Organisation über einen Zeitraum hinweg über die v3 API abrufen
## Berechtigungen
Erfordert einen [Service-Benutzer](/de/api-reference/v3/service-users/members-service-users) oder ein [persönliches Zugriffstoken](/de/api-reference/personal-access-tokens) mit der Berechtigung `ViewCodeScans` auf Organisationsebene.
## Zeitfilter
Dieser Endpunkt erfordert die Abfrageparameter `time_after` und `time_before`.
* Sowohl `time_after` als auch `time_before` sind **Unix-Zeitstempel in Sekunden**, die als UTC interpretiert werden.
* `time_after` muss vor `time_before` liegen.
* Der Zeitraum zwischen `time_after` und `time_before` darf **maximal 100 Tage** betragen.
* Die Metriken beziehen sich auf Code-Scans, die innerhalb dieses Zeitraums erstellt wurden.
Für Metriken für alle Organisationen eines Enterprise verwenden Sie [Code-Scan-Metriken abrufen (Enterprise)](/de/api-reference/v3/code-scans/enterprise-code-scans-metrics).
## OpenAPI
````yaml de/v3-openapi.yaml GET /v3/organizations/{org_id}/code-scans/metrics
openapi: 3.1.0
info:
description: Devin v3 API mit Service-User-Authentifizierung und 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: Code-Scan-Metriken abrufen
description: >-
Aggregierte Code-Scan-Metriken für die Organisation abrufen.
Gibt Metriken zu Scans, Befunden und Fehlerbehebungs-PRs für Code-Scans
zurück, die
innerhalb des angegebenen Zeitraums erstellt wurden.
operationId: >-
handle_get_code_scan_metrics_v3_organizations__org_id__code_scans_metrics_get
parameters:
- description: 'Organisations-ID (Präfix: 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: Erfolgreiche Antwort
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Nicht autorisiert
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Verboten
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Nicht gefunden
'409':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Konflikt
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Nicht verarbeitbarer Inhalt
'429':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Zu viele Anfragen
components:
schemas:
CodeScanMetricsResponse:
description: >-
Antwortmodell für Code-Scan-Metriken.
Alle Metriken beziehen sich auf Code-Scans, die innerhalb des
angegebenen Zeitraums erstellt wurden: Befunde und PRs zur
Fehlerbehebung werden dem Scan zugeordnet, durch den sie entstanden
sind.
properties:
avg_pr_open_duration_seconds:
anyOf:
- type: number
- type: 'null'
description: >-
Durchschnittliche Zeit, die eine PR offen ist (oder war), in
Sekunden: von der Erstellung bis zum Merge/Schließen bei
abgeschlossenen PRs, von der Erstellung bis jetzt bei offenen PRs.
Null, wenn keine PRs erstellt wurden.
title: Avg Pr Open Duration Seconds
avg_pr_time_to_merge_seconds:
anyOf:
- type: number
- type: 'null'
description: >-
Durchschnittliche Zeit von der PR-Erstellung bis zum Merge, in
Sekunden. Null, wenn keine PRs gemergt wurden.
title: Avg Pr Time To Merge Seconds
open_critical_findings_count:
description: Anzahl offener Befunde mit kritischem Schweregrad.
title: Open Critical Findings Count
type: integer
open_high_findings_count:
description: Anzahl offener Befunde mit hohem Schweregrad.
title: Open High Findings Count
type: integer
open_low_findings_count:
description: Anzahl offener Befunde mit niedrigem Schweregrad.
title: Open Low Findings Count
type: integer
open_medium_findings_count:
description: Anzahl offener Befunde mit mittlerem Schweregrad.
title: Open Medium Findings Count
type: integer
prs_closed_count:
description: >-
Anzahl der PRs zur Fehlerbehebung, die ohne Merge geschlossen
wurden.
title: Prs Closed Count
type: integer
prs_created_count:
description: >-
Anzahl der PRs, die von den Fehlerbehebungs-Sitzungen der Scans
erstellt wurden.
title: Prs Created Count
type: integer
prs_merged_count:
description: Anzahl gemergter PRs zur Fehlerbehebung.
title: Prs Merged Count
type: integer
prs_open_count:
description: >-
Anzahl der PRs zur Fehlerbehebung, die sich derzeit im Status
„offen“ befinden.
title: Prs Open Count
type: integer
repos_scanned_count:
description: Anzahl der gescannten unterschiedlichen Repositorys.
title: Repos Scanned Count
type: integer
scans_count:
description: Anzahl der Code-Scans, die im angegebenen Zeitraum erstellt wurden.
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: >-
RFC 9457 application/problem+json-Fehlertext für die v3-API.
detail wird aus dem Legacy-Body {"detail": ...} aus Gründen der
Abwärtskompatibilität beibehalten; die
anderen Member sind additiv. errors enthält Validierungsfehler auf
Feldebene
(nur 422).
properties:
detail:
anyOf:
- type: string
- type: 'null'
description: Eine menschenlesbare Erklärung, die speziell für diesen Fall gilt.
title: Detail
errors:
anyOf:
- items:
additionalProperties: true
type: object
type: array
- type: 'null'
description: Validierungsfehler auf Feldebene (nur bei 422-Antworten).
title: Errors
instance:
anyOf:
- type: string
- type: 'null'
description: Eine URI-Referenz (der Anfragepfad) für diesen Fall.
title: Instance
status:
description: Der HTTP-Statuscode.
title: Status
type: integer
title:
description: Eine kurze, menschenlesbare Zusammenfassung des Problemtyps.
title: Title
type: string
type:
default: about:blank
description: Eine URI-Referenz, die den Problemtyp identifiziert.
title: Type
type: string
required:
- title
- status
title: ProblemDetail
type: object
securitySchemes:
bearerAuth:
description: 'Servicebenutzer-Anmeldedaten (Präfix: cog_)'
scheme: bearer
type: http
````