JiraAPI

1.1.1

Private/Invoke-JiraApi.ps1

function Invoke-JiraApi {
    <#
    .SYNOPSIS
        Interner Low-Level-Wrapper um Invoke-RestMethod gegen die Jira Cloud REST API v3.
    #>
    [CmdletBinding()]
    param (
        [Parameter(Mandatory = $true)]
        [ValidateSet("Get", "Post", "Put", "Delete")]
        [string]
        $Method,

        [Parameter(Mandatory = $true)]
        [string]
        $Path,

        [Parameter(Mandatory = $false)]
        [object]
        $Body = $null,

        [Parameter(Mandatory = $false)]
        [hashtable]
        $Headers = @{}
    )

    begin {
        $ErrorActionPreference = "Stop"
        $AuthHeader = Confirm-JiraConnection
    }

    process {
        $Uri = "$($script:JIRA_BaseUrl)$Path"
        Write-Verbose "$Method $Uri"
        $AllHeaders = $AuthHeader.Clone()
        foreach ($Key in $Headers.Keys) { $AllHeaders[$Key] = $Headers[$Key] }

        $Params = @{
            Method  = $Method
            Uri     = $Uri
            Headers = $AllHeaders
        }
        $Params += Get-JiraProxyParams

        if ($null -ne $Body) {
            # Als UTF-8-Bytes statt String übergeben: Invoke-RestMethod kodiert einen String-Body
            # unter Windows PowerShell 5.1 nicht zuverlässig als UTF-8, was bei Sonderzeichen
            # (Umlaute, Gedankenstriche, Aufzählungszeichen etc.) zu "Invalid UTF-8" Fehlern der API führt.
            $JsonBody = $Body | ConvertTo-Json -Depth 20
            $Params.Body = [System.Text.Encoding]::UTF8.GetBytes($JsonBody)
            $Params.ContentType = "application/json; charset=utf-8"
        }

        try {
            $response = Invoke-RestMethod @Params
        }
        catch {
            $ApiError = Resolve-JiraApiError -ErrorRecord $_
            Write-Error $ApiError.Message
            Throw "Jira API Fehler ($($ApiError.StatusCode)): $($ApiError.Message)"
        }
    }

    end {
        return $response
    }
}