Base/Invoke-KBFApi.ps1
|
function Invoke-KBFApi { <# .SYNOPSIS Issues a get command to the kanbanflow api .DESCRIPTION The Kanbanflow API accepts the following command types: GET, POST and DELETE. This function encapsulates everything that is needed for a valid request. #> [CmdletBinding()] param ( [Parameter(Mandatory=$true)] [string]$ApiToken, [ValidateSet("Get","Post", "Delete")] [Parameter(Mandatory=$true)] [string]$Method, [Parameter(Mandatory=$true)] [string]$Command, [psobject]$Data = $null, [psobject]$Parameters = $null ) Process { Wait-KBFApiLimitBrake $authentication = New-KBFAuthHeader -ApiToken $ApiToken if ( [bool]$Data ) { # Remove empty properties from data $Data.PSObject.Properties | Where-Object { $_.Value -eq $null } | ForEach-Object { $Data.PSObject.Properties.Remove($_.Name) } Write-Verbose ($Data | ConvertTo-Json) } if ( $Method -eq "Get" ) { $url = "https://kanbanflow.com/api/v1/$Command" if ($Parameters -ne $null) { $ParametersEncoded = ConvertTo-UrlParameters $Parameters -StartWithQuestionmark $url = $url + $ParametersEncoded } $result = Invoke-RestMethod ` -Method Get ` -Headers $authentication ` -Uri $url Write-Verbose ($result | ConvertTo-Json) $result } if ( $Method -eq "Post" ) { if ($Data -eq $null) { throw "You have invoked a post command but did not pass any data! Please add -Data <PSObject> to add a data load to the command." } $asJson = $Data | ConvertTo-Json -Compress Invoke-RestMethod -Method Post ` -Headers $authentication ` -ContentType "application/json" ` -Uri https://kanbanflow.com/api/v1/$Command ` -Body $asJson } if ( $Method -eq "Delete" ) { $result = Invoke-RestMethod -Method Delete ` -Headers $authentication ` -Uri https://kanbanflow.com/api/v1/$Command # in case nothing special happens, we avoid a newline that is returned if ([bool]$result) { $result } } } } |