SonarQube-rapporter API#

Denna artikel beskriver hur man programatiskt får åtkomst till SonarQube säkerhetsrapporter lagrade i Procurize-plattformen. Den täcker REST‑API‑et för att lista och hämta rapporter samt ladda ner rapportarkiv.

Översikt#

SonarQube‑rapporter‑submodulen gör det möjligt för organisationer att centralt lagra och hantera säkerhets‑ och kodkvalitetsrapporter som genereras av SonarQube. Procurize‑plattformen exponerar dessa data via:

Ett REST‑API för att hämta metadata om lagrade rapporter
En endpoint för att ladda ner rapportartefakter som ZIP‑arkiv

Dessa funktioner möjliggör integrationer med CI/CD‑pipelines, GRC‑system, interna instrumentpaneler och tredjepartsverktyg för riskhantering.

Autentisering och Auktorisation#

Alla API‑förfrågningar som beskrivs i den här artikeln kräver ingen autentisering.

Organisations‑ID#

Ett organisations‑ID krävs för alla förfrågningar som beskrivs här.
Du hittar det i organisationens inställningspanel på https://dashboard.procurize.ai.
Observera att åtkomst till inställningspanelen kräver behörighet, och åtkomst till organisationens inställningspanel kräver minst rollen Administratör i den organisationen.

Kopiera ID‑knapp

Bas‑URL#

Alla REST‑API‑endpoints nås via följande bas‑URL:

https://api.procurize.com

SonarQube‑rapporter REST API#

Lista Rapporter#

Hämtar en paginerad lista över SonarQube‑säkerhetsrapporter som lagras i plattformen.

Endpoint

GET /security/report/list

Frågeparametrar

org (obligatoriskt): Organisations‑ID.
version (valfritt): Den exakta versionen av produkterna i Semantic Versioning‑format.
minver (valfritt): Minimum version av produkterna i Semantic Versioning‑format.
maxver (valfritt): Maximum version av produkterna i Semantic Versioning‑format.

Observera att minst ett av parametrarna version, minver eller maxver måste anges för förfrågan.

Exempel på förfrågan

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

Exempel på svar

{
  "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"
    }
  ]
}

Ladda ner Rapportarkiv#

Laddar ner ett ZIP‑arkiv som innehåller hela SonarQube‑rapportartefakter. Arkivet inkluderar HTML‑ och PDF‑rapporter.

Endpoint

GET /security/report/files

org (obligatoriskt): Organisations‑ID.
reports (obligatoriskt): Array av rapport‑ID:n.

Exempel på förfrågan

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"

Svar

Content‑Type: application/zip
Svars‑kroppen innehåller den binära ZIP‑filen

Klienter bör strömma svaret och spara det till disk.

Felsökning#

API‑et använder standard‑HTTP‑statuskoder.

200 OK: Förfrågan lyckades
204 No Content: Rapporten finns inte
400 Bad Request: Ogiltiga parametrar eller felaktig förfrågan
500 Internal Server Error: Oväntat serverfel

Felformulären innehåller en maskinläsbar felkod och ett människoläsbart meddelande.

Se även:#

SonarQube‑rapporter Webhooks

Relaterade artiklar#

Vad är säkerhetsrapporter?

Säkerhetsrapport‑arkiv

Hur man konfigurerar säkerhetsrapporter