SonarQube Raporları API#

Bu makale, Procurize platformunda depolanan SonarQube güvenlik raporlarına programatik olarak nasıl erişileceğini açıklar. Raporları listeleme ve alma ile rapor arşivlerini indirme için REST API’sini kapsar.

Genel Bakış#

SonarQube Raporları alt modülü, kuruluşların SonarQube tarafından oluşturulan güvenlik ve kod kalitesi raporlarını merkezi olarak saklamasına ve yönetmesine olanak tanır. Procurize platformu bu verileri şu yollarla sunar:

• Depolanan raporların meta verilerini almayı sağlayan bir REST API
• Rapor artefaktlarını ZIP arşivleri olarak indirmek için bir uç nokta

Bu yetenekler, CI/CD boru hatları, GRC sistemleri, iç panolar ve üçüncü taraf risk yönetimi araçlarıyla entegrasyonları mümkün kılar.

Kimlik Doğrulama ve Yetkilendirme#

Bu makalede açıklanan tüm API istekleri kimlik doğrulama gerektirmez.

Organizasyon ID’si#

Tüm istekler için bir organizasyon ID’si gereklidir.
Bu ID’yi Organizasyonun ayarlar paneli’nde https://dashboard.procurize.ai adresinden bulabilirsiniz.
Lütfen ayarlar paneline erişimin yetkilendirme gerektirdiğini ve organizasyon ayar paneline erişimin, o organizasyonda en az Yönetici rolüne sahip bir kullanıcı gerektirdiğini unutmayın.

Temel URL#

Tüm REST API uç noktaları aşağıdaki temel URL altında sunulur:

https://api.procurize.com

SonarQube Raporları REST API#

Raporları Listele#

Platformda depolanan SonarQube güvenlik raporlarının sayfalı bir listesini alır.

Endpoint

GET /security/report/list

Sorgu Parametreleri

• org (gerekli): Organizasyon ID’si.
• version (isteğe bağlı): Ürünlerin Semantic Versioning formatındaki kesin sürümü.
• minver (isteğe bağlı): Ürünlerin Semantic Versioning formatındaki minimum sürümü.
• maxver (isteğe bağlı): Ürünlerin Semantic Versioning formatındaki maksimum sürümü.

Lütfen istek için version, minver veya maxver parametrelerinden en az birinin gerekliliğine dikkat edin.

İstek Örneği

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

Yanıt Örneği

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

Rapor Arşivi İndir#

Tam SonarQube rapor artefaktlarını içeren bir ZIP arşivini indirir. Arşiv HTML ve PDF raporlarını içerir.

Endpoint

GET /security/report/files

• org (gerekli): Organizasyon ID’si.
• reports (gerekli): Rapor ID’lerinin dizisi.

İstek Örneği

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"

Yanıt

• İçerik Türü: application/zip
• Yanıt gövdesi ikili ZIP dosyasını içerir

İstemciler yanıtı akıtmalı ve diske kaydetmelidir.

Hata İşleme#

API standart HTTP durum kodlarını kullanır.

• 200 OK: İstek başarılı
• 204 No Content: Rapor mevcut değil
• 400 Bad Request: Geçersiz parametreler veya hatalı istek
• 500 Internal Server Error: Beklenmeyen sunucu hatası

Hata yanıtları makine tarafından okunabilir bir hata kodu ve insan tarafından okunabilir bir mesaj içerir.

İlgili Bağlantılar:#

• SonarQube Reports Webhooks

İlgili makaleler#

Güvenlik Raporları Nedir?

Güvenlik raporları deposu

Güvenlik Raporlarını Nasıl Yapılandırılır