> ## 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.
# Obtener métricas de análisis de código (API de Devin)
> Obtén métricas agregadas de análisis de código, hallazgos y PR de remediación de Devin para una organización durante un intervalo de tiempo mediante la API v3
## Permisos
Requiere un [usuario de servicio](/es/api-reference/v3/service-users/members-service-users) o un [token de acceso personal](/es/api-reference/personal-access-tokens) con el permiso `ViewCodeScans` a nivel de organización.
## Filtros de tiempo
Este endpoint requiere los parámetros de consulta `time_after` y `time_before`.
* Tanto `time_after` como `time_before` son **marcas de tiempo Unix en segundos**, interpretadas como UTC.
* `time_after` debe ser anterior a `time_before`.
* El intervalo entre `time_after` y `time_before` debe ser de **100 días o menos**.
* Las métricas se limitan a los análisis de código creados dentro de este intervalo.
Para consultar las métricas de todas las organizaciones de una empresa, use [Get Code Scan Metrics (Enterprise)](/es/api-reference/v3/code-scans/enterprise-code-scans-metrics).
## OpenAPI
````yaml es/v3-openapi.yaml GET /v3/organizations/{org_id}/code-scans/metrics
openapi: 3.1.0
info:
description: API de Devin v3 con autenticación mediante usuario de servicio y 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: Obtener métricas de análisis de código
description: >-
Obtener métricas agregadas de análisis de código para la organización.
Devuelve métricas de análisis, hallazgos y PR de remediación para los
análisis de código creados
dentro del intervalo de tiempo especificado.
operationId: >-
handle_get_code_scan_metrics_v3_organizations__org_id__code_scans_metrics_get
parameters:
- description: 'ID de la organización (prefijo: 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: Respuesta exitosa
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: No autorizado
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Prohibido
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: No encontrado
'409':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Conflicto
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Contenido no procesable
'429':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Demasiadas solicitudes
components:
schemas:
CodeScanMetricsResponse:
description: >-
Modelo de respuesta para las métricas de análisis de código.
Todas las métricas se limitan a los análisis de código creados dentro
del intervalo de tiempo especificado: los hallazgos y las PR de
remediación se atribuyen al análisis que los produjo.
properties:
avg_pr_open_duration_seconds:
anyOf:
- type: number
- type: 'null'
description: >-
Tiempo promedio que una PR está (o estuvo) abierta, en segundos:
desde su creación hasta el merge o cierre para las PR finalizadas;
desde su creación hasta ahora para las PR abiertas. Null cuando no
se creó ninguna PR.
title: Avg Pr Open Duration Seconds
avg_pr_time_to_merge_seconds:
anyOf:
- type: number
- type: 'null'
description: >-
Tiempo promedio desde la creación de la PR hasta el merge, en
segundos. Null cuando no se ha fusionado ninguna PR.
title: Avg Pr Time To Merge Seconds
open_critical_findings_count:
description: Número de hallazgos abiertos con gravedad critical.
title: Open Critical Findings Count
type: integer
open_high_findings_count:
description: Número de hallazgos abiertos con gravedad high.
title: Open High Findings Count
type: integer
open_low_findings_count:
description: Número de hallazgos abiertos con gravedad low.
title: Open Low Findings Count
type: integer
open_medium_findings_count:
description: Número de hallazgos abiertos con gravedad medium.
title: Open Medium Findings Count
type: integer
prs_closed_count:
description: Número de PR de remediación cerradas sin fusionarse.
title: Prs Closed Count
type: integer
prs_created_count:
description: >-
Número de PR creadas por las sesiones de remediación de los
análisis.
title: Prs Created Count
type: integer
prs_merged_count:
description: Número de PR de remediación fusionadas.
title: Prs Merged Count
type: integer
prs_open_count:
description: Número de PR de remediación que están actualmente abiertas.
title: Prs Open Count
type: integer
repos_scanned_count:
description: Número de repositorios distintos analizados.
title: Repos Scanned Count
type: integer
scans_count:
description: >-
Número de análisis de código creados dentro del intervalo de tiempo
especificado.
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: >-
Cuerpo de error RFC 9457 application/problem+json para la API v3.
detail se conserva del cuerpo heredado {"detail": ...} por
compatibilidad con versiones anteriores; los
otros miembros son adicionales. errors contiene errores de validación
a nivel de campo (solo 422).
properties:
detail:
anyOf:
- type: string
- type: 'null'
description: Explicación legible para humanos específica de esta ocurrencia.
title: Detail
errors:
anyOf:
- items:
additionalProperties: true
type: object
type: array
- type: 'null'
description: Errores de validación por campo (solo en respuestas 422).
title: Errors
instance:
anyOf:
- type: string
- type: 'null'
description: Una referencia URI (la ruta de la solicitud) para esta ocurrencia.
title: Instance
status:
description: El código de estado HTTP.
title: Status
type: integer
title:
description: Un breve resumen del tipo de problema, legible para humanos.
title: Title
type: string
type:
default: about:blank
description: Una referencia URI que identifica el tipo de problema.
title: Type
type: string
required:
- title
- status
title: ProblemDetail
type: object
securitySchemes:
bearerAuth:
description: 'Credencial de usuario de servicio (prefijo: cog_)'
scheme: bearer
type: http
````