functions/New-ApiRequest.ps1
|
function New-ApiRequest { <# .SYNOPSIS Makes a API request. .DESCRIPTION Returns the API response. .PARAMETER apiMethod Provide API Method GET, PUT or POST .PARAMETER apiRequest See Datto RMM API swagger UI .PARAMETER apiRequestBody Only used with PUT and POST request .OUTPUTS API response #> Param( [Parameter(Mandatory=$True)] [ValidateSet('GET','PUT','POST')] [string]$apiMethod, [Parameter(Mandatory=$True)] [string]$apiRequest, [Parameter(Mandatory=$False)] [string]$apiRequestBody ) # Get API Token $apiAccessToken = New-ApiAccessToken # Define parameters for Invoke-WebRequest cmdlet $params = [ordered] @{ Uri = '{0}/api{1}' -f $apiUrl, $apiRequest Method = $apiMethod ContentType = 'application/json' Headers = @{ 'Authorization' = 'Bearer {0}' -f $apiAccessToken } } # Add body to parameters if present If ($apiRequestBody) {$params.Add('Body',$apiRequestBody)} # Make request try { (Invoke-WebRequest @params).Content } catch { switch ($_.Exception.Message) { 'The remote server returned an error: (400) Bad Request.' { throw '400 - Bad Request.' } 'The remote server returned an error: (401) Unauthorized.' { throw '401 - Unauthorized, please check your credentials.' } 'The remote server returned an error: (429).' { Write-Host '429 - API rate limit breached, sleeping for 60 seconds' Start-Sleep -Seconds 60 } 'The remote server returned an error: (403) Forbidden.' { Write-Host '403 - AWS DDOS protection breached, sleeping for 5 minutes' Start-Sleep -Seconds 300 } default { Write-Host $_.Exception.Message Exit } } } } |