API dei report SonarQube#

Questo articolo descrive come accedere programmaticamente ai report di sicurezza SonarQube memorizzati sulla piattaforma Procurize. Copre l’API REST per elencare e recuperare i report e per scaricare gli archivi dei report.

Panoramica#

Il sotto-modulo SonarQube Reports consente alle organizzazioni di archiviare e gestire centralmente i report di sicurezza e di qualità del codice generati da SonarQube. La piattaforma Procurize espone questi dati tramite:

Un’API REST per recuperare i metadati dei report archiviati
Un endpoint per scaricare gli artefatti dei report come archivi ZIP

Queste funzionalità consentono integrazioni con pipeline CI/CD, sistemi GRC, dashboard interne e strumenti di gestione del rischio di terze parti.

Autenticazione e autorizzazione#

Tutte le richieste API descritte in questo articolo non richiedono autenticazione.

ID dell’organizzazione#

È richiesto un ID organizzazione per tutte le richieste descritte qui.
Puoi trovarlo nel pannello impostazioni dell’organizzazione all’indirizzo https://dashboard.procurize.ai.
Nota che l’accesso al pannello impostazioni richiede un’autorizzazione, e l’accesso al pannello impostazioni dell’organizzazione richiede un ruolo utente di almeno Amministratore in quella organizzazione.

Pulsante Copia ID

URL di base#

Tutti gli endpoint dell’API REST sono disponibili sotto il seguente URL di base:

https://api.procurize.com

API REST dei report SonarQube#

Elencare i report#

Recupera un elenco paginato di report di sicurezza SonarQube memorizzati nella piattaforma.

Endpoint

GET /security/report/list

Parametri di query

org (obbligatorio): ID organizzazione.
version (opzionale): La versione esatta del prodotto nel formato Semantic Versioning.
minver (opzionale): La versione minima del prodotto nel formato Semantic Versioning.
maxver (opzionale): La versione massima del prodotto nel formato Semantic Versioning.

Nota che è richiesto almeno uno dei parametri version, minver o maxver per la richiesta.

Esempio di richiesta

curl "https://api.procurize.com/security/report/list?org=00000000-0000-0000-0000-000000000001&version=1.0"

Esempio di risposta

{
  "organizationId": "00000000-0000-0000-0000-000000000001",
  "reports": [
    {
      "projectName": "Test product",
      "id": "00000000-0000-0000-0000-000000000002",
      "reportType": "CWE Top 25",
      "reportVersion": 2024,
      "projectVersion": "1.0",
      "date": "2025-12-17T09:05:48.5946432+00:00",
      "uploadDate": "2025-12-17T09:05:48.5946432+00:00",
      "vulnerabilitiesCount": 0,
      "securityRating": "A"
    }
  ]
}

Scaricare l’archivio del report#

Scarica un archivio ZIP contenente tutti gli artefatti completi del report SonarQube. L’archivio include i report in HTML e PDF.

Endpoint

GET /security/report/files

org (obbligatorio): ID organizzazione.
reports (obbligatorio): Array di ID dei report.

Esempio di richiesta

curl "https://api.procurize.com/security/report/files?org=00000000-0000-0000-0000-000000000001&reports=00000000-0000-0000-0000-000000000002&reports=00000000-0000-0000-0000-000000000003"

Risposta

Content‑Type: application/zip
Il corpo della risposta contiene il file ZIP binario

I client dovrebbero effettuare lo streaming della risposta e salvarlo su disco.

Gestione degli errori#

L’API utilizza i codici di stato HTTP standard.

200 OK: Richiesta completata con successo
204 No Content: Il report non esiste
400 Bad Request: Parametri non validi o richiesta malformata
500 Internal Server Error: Errore interno del server inatteso

Le risposte di errore includono un codice di errore leggibile dalla macchina e un messaggio leggibile dall’uomo.

Vedi anche:#

Webhooks dei report SonarQube