Assuming you’re using PowerShell 3.0 (you better be!) you can use the new method tool for REST APIs called “Invoke-RestMethod”.

It’s quite nice to have a REST parser instead of trying to write some sort of custom thing specific to each REST application I’ve needed to interact.

This little piece of demonstration code below demonstrates a way to create a new helpdesk request with an XML package, submitted through the ServiceDesk Plus URI.

In a future post, I may get around to writing additional examples that demonstrate updating existing requests. This should be pretty straightforward, as the object returned from Invoke-RestMethod returns the calls from the REST server. In this SDP implementation, you get the ID of the request returned, which you can utilize later to modify and update all aspects of an existing request.

function new-helprequest
{
	param(
			[string]$requester="Lastname, Firstname",
			[string]$subject="null",
			[string][Parameter(Mandatory=$true)]$description,
			[string]$category="Unknown",
			[string]$subcategory="Unknown",
			[string]$impact="Impacts User",
			[string]$urgency="Low",
			[string]$site="Sitename")

	#this is an xml template to generate new SDP requests
	$requestXML=[xml]("<Operation>
		<Details>
			<requester></requester>
			<subject></subject>
			<description></description>
			<category></category>
			<subcategory></subcategory>
			<impact></impact>
			<urgency></urgency>
			<site></site>
		</Details>
	</Operation>")

	$url = "https://help.domain.com" #url to your helpdesk server
	$api = "/sdpapi/request/?" #api path, which is pretty much the same for SDP 8+
	$operation = "ADD_REQUEST" #the operation
	$apiKey = "541240AE9-197D-4F91-BDBC-7C614CA980D7" #the api key you generated from one of your technician accounts.

	#Configure the parameters for the xml with the content from the command parameters
	$requestXML.operation.details.requester = $requester
	$requestXML.operation.details.subject = $subject
	$requestXML.operation.details.description = $description
	$requestXML.operation.details.category = $category
	$requestXML.operation.details.subcategory = $subcategory
	$requestXML.operation.details.impact = $impact
	$requestXML.operation.details.urgency = $urgency
	$requestXML.operation.details.site = $site

	$uri = $url + $api + "OPERATION_NAME=" + $operation + "&TECHNICIAN_KEY=" + $apiKey + "&INPUT_DATA=" + $requestXML.InnerXml #assemble a URI. SDP expects a paramatized URI method to generate requests.
	Invoke-RestMethod -Method post -Uri $uri
}