API-ul de Rapoarte SonarQube#

Acest articol descrie cum să accesați programatic rapoartele de securitate SonarQube stocate în platforma Procurize. Acoperă API‑ul REST pentru listarea și preluarea rapoartelor și descărcarea arhivelor de rapoarte.

Prezentare generală#

Submodulul Rapoarte SonarQube permite organizațiilor să stocheze și să gestioneze centralizat rapoartele de securitate și calitate a codului generate de SonarQube. Platforma Procurize expune aceste date prin:

• Un API REST pentru preluarea metadatelor despre rapoartele stocate
• Un punct final pentru descărcarea artefactelor de raport ca arhive ZIP

Aceste capabilități permit integrarea cu pipeline‑uri CI/CD, sisteme GRC, dashboard‑uri interne și instrumente terțe de management al riscurilor.

Autentificare și autorizare#

Toate cererile API descrise în acest articol nu necesită autentificare.

ID-ul organizației#

Un ID de organizație este necesar pentru toate cererile descrise aici.
Îl puteți găsi în panoul de setări al organizației la https://dashboard.procurize.ai.
Rețineți că accesul la panoul de setări necesită autorizare, iar accesul la setările unei organizații necesită un rol de utilizator de cel puțin Administrator în acea organizație.

URL de bază#

Toate punctele finale ale API‑ului REST sunt servite sub următorul URL de bază:

https://api.procurize.com

API REST pentru Rapoarte SonarQube#

Listarea rapoartelor#

Recuperează o listă paginată de rapoarte de securitate SonarQube stocate în platformă.

Punct final

GET /security/report/list

Parametri de interogare

• org (obligatoriu): ID-ul organizației.
• version (opțional): Versiunea exactă a produselor, în formatul Semantic Versioning.
• minver (opțional): Versiunea minimă a produselor, în formatul Semantic Versioning.
• maxver (opțional): Versiunea maximă a produselor, în formatul Semantic Versioning.

Rețineți că pentru cerere este necesar cel puțin unul dintre parametrii version, minver sau maxver.

Exemplu de solicitare

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

Exemplu de răspuns

{
  "organizationId": "00000000-0000-0000-0000-000000000001",
  "reports": [
    {
      "projectName": "Produs test",
      "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"
    }
  ]
}

Descărcarea arhivei de raport#

Descarcă o arhivă ZIP care conține toate artefactele complete ale raportului SonarQube. Arhiva include rapoarte în format HTML și PDF.

Punct final

GET /security/report/files

• org (obligatoriu): ID-ul organizației.
• reports (obligatoriu): Tabla cu ID‑urile rapoartelor.

Exemplu de solicitare

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"

Răspuns

• Content‑Type: application/zip
• Corpul răspunsului conține fișierul ZIP binar

Clienții trebuie să stream răspunsul și să îl salveze pe disc.

Gestionarea erorilor#

API‑ul utilizează codurile standard de stare HTTP.

• 200 OK: Cerere reușită
• 204 No Content: Raportul nu există
• 400 Bad Request: Parametri invalizi sau cerere malformată
• 500 Internal Server Error: Eroare neașteptată a serverului

Răspunsurile de eroare includ un cod de eroare mașină‑citibil și un mesaj pentru utilizator.

Vezi și:#

• Webhook‑uri pentru Rapoarte SonarQube

Articole conexe#

Ce sunt rapoartele de securitate?

Depozitul rapoartelor de securitate

Cum se configurează rapoartele de securitate