internal/functions/Core/Format-ApiPath.ps1
|
function Format-ApiPath { <# .Synopsis Format-ApiPath .DESCRIPTION Ensure the right format of api path uri .PARAMETER Path Path to format .PARAMETER QueryParameter A hashtable for all the parameters to the api route .PARAMETER Token AccessToken object for Personio service .EXAMPLE Format-ApiPath -Path $ApiPath Api path data from variable $ApiPath will be tested and formatted. .NOTES Author: Andreas Bellstedt .LINK https://github.com/AndiBellstedt/PSPersonio #> [CmdletBinding( SupportsShouldProcess = $false, ConfirmImpact = 'Low' )] Param( [Parameter(Mandatory = $true)] [string] $Path, [Personio.Core.AccessToken] $Token, [hashtable] $QueryParameter ) if (-not $Token) { $Token = $script:PersonioToken } Write-PSFMessage -Level System -Message "Formatting API path '$($Path)'" # Remove no more need slashes $apiPath = $Path.Trim('/') # check on API path prefix if (-not $ApiPath.StartsWith($token.ApiUri)) { $apiPath = $token.ApiUri.Trim('/') + "/" + $apiPath Write-PSFMessage -Level System -Message "Add API prefix, finished formatting path to '$($apiPath)'" } else { Write-PSFMessage -Level System -Message "Prefix API path already present, finished formatting" } # If specified, process hashtable QueryParameters to valid parameters into uri if ($QueryParameter) { $apiPath = "$($apiPath)?" $i = 0 foreach ($key in $QueryParameter.Keys) { if ($i -gt 0) { $apiPath = "$($apiPath)&" } if ("System.Array" -in ($QueryParameter[$Key]).psobject.TypeNames) { $parts = $QueryParameter[$Key] | ForEach-Object { "$($key)=$($_)" } $apiPath = "$($apiPath)$([string]::Join("&", $parts))" } else { $apiPath = "$($apiPath)$($key)=$($QueryParameter[$Key])" } $i++ } } # Output Result $apiPath } |