// POST https://api.ams.fortify.com/oauth/token
// Header
{
    "scope": "api-tenant", // scope 要去你的帳號設定查看。
    "grant_type": "password", // 取得權限是用password形式。
    "username": "<tenant>\\<user_name>", // tenant跟user name也是要去帳號設定查看，記得注意一個反斜線 \，但若是在程式碼內需要兩個反斜線\\，防止程式辨別特數字元。
    "password": "<personal_token>" // 注意此項不是放你的密碼，是放你在設定裡產生的那組token。
}

{
    "access_token": "ZGHJ3274JDK" //送出請求後，可從response獲得一組token，這邊只是隨便寫代表，實際上很長。
}

// GET https://api.ams.fortify.com/api/v3/application
// Header
{
    "Content-Type": "application/json", 
    "Accept": "application/json", 
    "Authorization": "Bearer <token>", // 這邊要放你剛剛call Oauth取得的token
}

{
    ...,
    "items": [{
        "applicationName": "",
        "applicationId": "",
        ...
    }, {
        ...
    }
    ]
}

// GET https://api.ams.fortify.com/api/v3/release or https://api.ams.fortify.com/api/v3/application/<application_id>/release
// Header
{
    "Content-Type": "application/json", 
    "Accept": "application/json", 
    "Authorization": "Bearer <token>", // 這邊要放你剛剛call Oauth取得的token
}

// Params -> 注意是Parameters，不是Body，這是Get請求，Python請放requests.get(params=<params>)，postman請把參數放在Params，我被這坑到。
{
    "filter": "ReleaseName:<service_name>" // 這是單一filter案例，多個請用 + 分開
}

// POST https://<host_name>/api/tokens/authenticate
// Header
{
    "Accept": "application/vnd.blackducksoftware.user-4+json", 
    "Authorization": "token <personal_token>", // 你可以在Black Duck的網站右上方人頭 -> Access token 產生一個 personal token，然後注意如果你需要產報告，你要把write權限打勾。
    // Authorization的值，請拜託一定要在前面加 token，才把personal token寫下去，我當時卡這個卡的一臉懵，卡一陣子，例子: "Authorization": "token GH2395JKls=="
}

{
    "bearerToken": "ZGHJ3274JDK" //送出請求後，可從response獲得一組token，這邊只是隨便寫代表，實際上很長。
}

// GET https://<host_name>/api/projects
// Header
{
    "Authorization": "Bearer <bearerToken>", // 這邊要放你剛剛取得的BearerToken
}
// Params -> 沒錯又是Parameters，這是get請求，不要放去body。
// 如果你需要 limit限制回傳的筆數或者filter過濾你要找的projects，才需要這個parameters，如果沒有params，會回傳全部的projects (有限制筆數)
{
    "limit": 5, // 我限制5筆就好
    "q": "name:<filter_name>" // 沒錯就是一個 q，這欄是filter，如果你想查指定名稱的project，就照這樣填，不確定其他可以filter的欄位。
}

{
    ...,
    "items": [{
        "name": "",
        "_meta": {
            "href": ""
        },
        ...
    }, {
        ...
    }
    ]
}

// GET https://<host_name>/api/projects/<project_id>/versions
// Header
{
    "Authorization": "Bearer <bearerToken>", // 這邊要放你剛剛取得的BearerToken
}

{
    "items": [{
        "versionName": "master",
        ...,
        "_meta": {
            "href": ""
        },
    },
    {
        "versionName": "version_1",
        ...,
        "_meta": {
            "href": ""
        },
    }
    ]
}

// POST https://<host_name>/api/versions/<version_id>/reports
// 沒錯很奇怪，居然不需要project_id，我懷疑他萬一有重複的version_id會怎麼判斷。
// Header
{
    "Content-Type": "application/json",
    "Authorization": "Bearer <bearerToken>", // 這邊要放你剛剛取得的BearerToken
}

// Body -> 終於是 body了，post請求哈。
{
    "reportFormat": "CSV", // 這邊我們選csv，但我記得可以填JSON
    "reportType": "VERSION",
    "caregories": ["VERSION", "COMPONENTS", "SECURITY", "PROJECT_VERSION_CUSTOM_FIELDS"] // 這邊就是你產報告時，他會有Categories 的打勾勾選項，你選哪些，這邊就填哪些。
}

{
    "links": {
        "download": {
            "url"
        }
    }
}

// GET https://<host_name>/api/projects/<project_id>/versions/<version_id>/reports/<report_id>/download
// 真奇妙，產報告不需要 project_id，載報告需要，難道report_id是會重複的？
// Header
{
    "Authorization": "Bearer <bearerToken>", // 這邊要放你剛剛取得的BearerToken
}

# 如果是下載在local
import io
import zipfile

response = requests.get(url, headers=headers)
if response.status_code == 200:
    z = zipfile.ZipFile(io.BytesIO(response.content))
    z.extractall("./")

# 如果是想存進 AWS S3
import io
import boto3
import zipfile

s3_client = boto3.client("s3")

s3_bucket = "<bucket_name>"

response = requests.get(url, headers=headers)
if response.status_code == 200:
    z = zipfile.ZipFile(io.BytesIO(response.content))
    for file_info in z.infolist():
        file_name = file_info.filename

        # 讀取 file content
        file_content = z.read(file_name)

        save_key = f"<prefix>/{file_name}"

        # 上傳檔案內容到S3
        s3_client.upload_fileobj(io.BytesIO(file_content), s3_bucket, save_key)

// GET https://<host_name>/api/projects/<project_id>/versions/<version_id>/components
// 一樣要填 project_id 和 version_id

// Header
{
    "Authorization": "Bearer <bearerToken>", // 這邊要放你剛剛取得的BearerToken
}

// Params -> Parameters 哈，這邊用GET方式
{
    "limit": 10, // 看你要不要設筆數
    "filter": "bomPolicy:in_violation" // filter -> 欄位:選項
}

// 如果沒有找到filter符合的資料，items會留空 []。
{
    "items": [{
        "componentName": "",
        "componentVersionName": ""
    },
    {
        "componentName": "",
        "componentVersionName": ""
    }
    ]
}