SonarQube ანგარიშის API

ეს სტატია აღნიშნავს, თუ როგორ მივეჰყავდი SonarQube‑ის უსაფრთხოების ანგარიშებს, რომლებიც შენახულია Procurize პლატფორმაზე, პროგრამული გზით. იგი აღწერს REST API‑ს, რომელიც სერვისზეა უსაფრთხოების ანგარიშების სია, მათი მიღება და ანგარიშის არქივის ჩამოტვირთვა.

მიმოხილვა

SonarQube ანგარიშების ქვედამატება აძლევს ორგანიზაციებს საშუალობას ცენტრალურად შესანახა და განაყრილის უსაფრთხოების და კოდის ხარისხის ანგარიშებს, რომლებიც შექმნილია SonarQube‑ისგან. Procurize პლატფორმა ამ მონაცემებს იპარებს:

REST API შენახული ანგარიშის მეტამონაცემების მოსაძებნად
ბინდელი ანგარიშის არფაქტის ZIP არქივის სახით ჩამოტვირთვაზე

ეს შესაძლებლობები საშუალებას აძლევს ინტეგრაციებს CI/CD პაიპლაინებთან, GRC სისტემებთან, შიდა ფურცლებთან და მესამე‑მხარის რისკის მართვის ხელსაწყოებთან.

აუთენტიფიკაცია და ავტორიზაცია

მოთხოვნები, რომლებიც აღწერა სტატიის შიგთავსში, არ საჭიროებს აუთენტიფიკაციას.

ორგანიზაციის ID

ყველა მოთხოვნისთვის, სადაც აღნიშნულია, საჭიროა ორგანიზაციის ID. მისი პოვნა შესაძლებელია ორგანიზაციის პარამეტრების პანელში https://dashboard.procurize.ai. გაითვალისწინეთ, რომ პარაკეტრების პანელში შესვლა საჭიროებს ავტორიზაციას, ხოლო ორგანიზაციის პარამეტრების პანელში შესვლა საჭიროა მინიმუმ ადმინისტრატორი როლის მქონე მომხმარებელი.

ID-ის kopiirobuli ღილაკი

საბაზისო URL

ყველა REST API ბინდელი ყოფნების ქვედა URL‑სა შიდა ფორმით:

https://api.procurize.com

SonarQube ანგარიშის REST API

ანგარიშების სია

აკრებული სისტემის დარბამულია SonarQube‑ის უსაფრთხოების ანგარიშის დაპროცეობებისა.

ბინდელი

GET /security/report/list

მოთხოვნის არგუმენტები

org (აუცილებელია): ორგანიზაციის ID.
version (არავალოციური): პროდუქტის ზუსტი ვერსია სემანტიკური ვერსიონირების ფორმატში.
minver (არავალოციური): პროდუქტის მინიმალური ვერსია სემანტიკური ვერსიონირების ფორმატში.
maxver (არავალოციური): პროდუქტის მაქსიმალური ვერსია სემანტიკური ვერსიონირების ფორმატში.

გთხოვთ, გაითვალისწინოთ, რომ მოთხოვნისთვის საჭიროა ერთი მაინც პარამეტრი version, minver ან maxver.

მოთხოვნის მაგალითი

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

პასუხის მაგალითი

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

ანგარიშის არქივის ჩამოტვირთვა

ჩამოტვირთავს ZIP არქივს, რომელსაც მოიცავს SonarQube-ის სრულ ანგარიშის არფაქტები. არქივი შეიცავს HTML და PDF ფორმატის ანგარიშებს.

ბინდელი

GET /security/report/files

org (აუცილებელია): ორგანიზაციის ID.
reports (აუცილებელია): ანგარიშის ID‑თა მასივი.

მოთხოვნის მაგალითი

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"

პასუხი

Content-Type: application/zip
პასუხის სხეული შეიცავს ბინარულ ZIP ფაილს

კლიენტები უნდა გადაიქვეყნოთ პასუხი და შეინახოთ იგი დისკზე.

შეცდომის დამუშავება

API იყენებს სტანდარტულ HTTP სტატუსის კოდებს.

200 OK: მოთხოვნა წარმატებულია
204 No Content: ანგარიში არ არსებობს
400 Bad Request: არასწორი პარამეტრები ან დაზიანებული მოთხოვნა
500 Internal Server Error: გაურკვეველი სერვერის შეცდომა

შეცდომის პასუხები მოიცავენ მანქანათის‑წაკითხვადი შეცდომის კოდს და ადამიანის‑წაკითხვადი შეტყობინებას.

იხილეთ ასევე:

SonarQube ანგარიშის Webhooks

சம்பანდებული სტატია

რას წარმოადგენს უსაფრთხოების ანგარიშები?

უსაფრთხოების ანგარიშის სანდრო ნომერი

როგორ დავაკონფიგურიროთ უსაფრთხოების ანგარიშები