A request to the GFI HelpDesk REST API request is simply an HTTPHypertext Transfer Protocol - A protocol for exchange of hypertext documents in HTML. request with the URLUniform Resource Locator is the address of a web page on the world wide web. set to the path of the helpdesk app (such as Base), controller (like User) and parameters containing the payload of the request.
The GFI HelpDesk API is a "RESTful web API" (read more about the format on Wikipedia). The API uses plain XML for receiving and dispatching data.
The API uses all four REST commands -
DELETE. These commands correspond to respective actions inside the helpdesk.
PUT are not interchangeable. Each has a specified function.
||Create||Create an item (such as a ticket).|
||Retrieve (Read)||Retrieve an item or list of items (such as a list of tickets).|
||Update||Modify an existing item or list of items (such as changing the owner of an existing ticket).|
||Delete||Permanently remove an item or group of items (such as deleting a helpdesk user).|
Your helpdesk API can be accessed at
What a Request Looks Like
?e=/App/Controller/Action ¶meterA=valueA ¶meterB=valueB ¶meterC=valueC &apikey=d75a00ef-08b6-5b04-5d29-d3b7ca46138a &salt=itobgt701t5nat7oor9z4t813edc5t8d&
The URL you use for the API depends on the URL you find at Admin Control Panel > API > Settings. From there you can use a URL similar to
https://mycompany.gfihelpdesk.com/api/ as your API base.
If you encounter an error after multiple attempts, you might need to configure your request with
https://mycompany.gfihelpdesk.com/api/index.php, and by adding that it should work out fine.