> ## Documentation Index
> Fetch the complete documentation index at: https://docs.corgea.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Répertorier les groupes de problèmes de qualité du code d’une analyse

> Récupérer les problèmes de qualité du code d’une analyse regroupés, avec un décompte par groupe, afin qu’un client puisse afficher une synthèse sans télécharger chaque problème. Accepte les mêmes filtres que GET /scan/{scan_id}/issues/quality.



## OpenAPI

````yaml /fr/api-reference/openapi.json get /scan/{scan_id}/issues/quality/groups
openapi: 3.0.0
info:
  title: API Corgea
  version: 1.0.0
  description: >-
    API permettant d’interagir avec les fonctionnalités d’analyse et de gestion
    des vulnérabilités de Corgea
servers:
  - url: https://www.corgea.app/api/v1
    description: Serveur de production
  - url: https://eu.corgea.app/api/v1
    description: Serveur de production UE
security:
  - CorgeaToken: []
  - BearerAuth: []
paths:
  /scan/{scan_id}/issues/quality/groups:
    get:
      tags:
        - Problèmes
        - Analyses
      summary: Répertorier les groupes de problèmes de qualité du code d’une analyse
      description: >-
        Récupérer les problèmes de qualité du code d’une analyse regroupés, avec
        un décompte par groupe, afin qu’un client puisse afficher une synthèse
        sans télécharger chaque problème. Accepte les mêmes filtres que GET
        /scan/{scan_id}/issues/quality.
      operationId: listCodeQualityIssueGroupsForScan
      parameters:
        - name: scan_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: L’analyse dont les problèmes doivent être regroupés
        - name: group_by
          in: query
          required: false
          schema:
            type: string
            enum:
              - cwe
              - file_path
            default: cwe
          description: >-
            Critère de regroupement des problèmes. cwe regroupe par
            classification CWE ; file_path regroupe par fichier exact dans
            lequel chaque problème a été détecté.
          example: file_path
        - name: breakdown
          in: query
          required: false
          schema:
            type: boolean
            default: false
          description: Inclure les décomptes par urgence et par statut pour chaque groupe
        - name: page
          in: query
          required: false
          schema:
            type: integer
            default: 1
          description: Le numéro de page pour la pagination
        - name: page_size
          in: query
          required: false
          schema:
            type: integer
            default: 20
            maximum: 100
          description: Le nombre de groupes par page
      responses:
        '200':
          description: Groupes de problèmes récupérés avec succès
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: ok
                  page:
                    type: integer
                  total_pages:
                    type: integer
                  total_groups:
                    type: integer
                  groups:
                    type: array
                    items:
                      oneOf:
                        - $ref: '#/components/schemas/IssueCweGroup'
                        - $ref: '#/components/schemas/IssueFileGroup'
        '400':
          description: Valeur de group_by non valide
        '404':
          description: >-
            Analyse introuvable ou, lorsque le contrôle d’accès aux projets est
            activé, l’appelant n’est pas administrateur de l’entreprise et n’a
            pas accès au projet de l’analyse.
components:
  schemas:
    IssueCweGroup:
      type: object
      required:
        - cwe
        - issue_count
      description: >-
        Groupe de problèmes partageant la même classification CWE, renvoyé
        lorsque group_by vaut cwe.
      properties:
        cwe:
          type: object
          properties:
            id:
              type: string
              example: CWE-89
            name:
              type: string
            description:
              type: string
        issue_count:
          type: integer
          example: 42
        breakdown:
          $ref: '#/components/schemas/IssueGroupBreakdown'
    IssueFileGroup:
      type: object
      required:
        - file
        - issue_count
      description: >-
        Groupe de problèmes partageant le même chemin de fichier, renvoyé
        lorsque group_by vaut file_path.
      properties:
        file:
          type: object
          properties:
            path:
              type: string
              example: src/api/auth.py
            name:
              type: string
              example: auth.py
        issue_count:
          type: integer
          example: 7
        breakdown:
          $ref: '#/components/schemas/IssueGroupBreakdown'
    IssueGroupBreakdown:
      type: object
      description: >-
        Décomptes au sein du groupe, présents uniquement lorsque breakdown vaut
        true.
      properties:
        by_urgency:
          type: object
          additionalProperties:
            type: integer
          example:
            CR: 5
            HI: 10
            ME: 20
            LO: 7
        by_status:
          type: object
          additionalProperties:
            type: integer
          example:
            open: 30
            fixed: 5
            false_positive: 2
            accepted_risk: 1
            fix_in_progress: 3
            duplicate: 1
  securitySchemes:
    CorgeaToken:
      type: apiKey
      in: header
      name: CORGEA-TOKEN
      description: >-
        Clé API pour l'authentification Les jetons API des utilisateurs inactifs
        sont refusés.
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Jeton d’accès OAuth2 (JWT) dans l’en-tête Authorization

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.