Tutorial

These tutorials will guide you through the steps needed to access and view the API in TOPdesk and see some examples. It will not tell you anything about the techniques used: HTTP, REST and JSON.

Note: As you are reading this we assume you already have a TOPdesk 7.11.005 or later running. If you are using an older TOPdesk version, please refer to the old tutorial

In the tutorials we refer to a TOPdesk installation that is running on localhost (http://localhost).

General configuration

Configure TOPdesk

Settings and permissions needed to make use of the API

Download and set up Postman

Set up Postman to create and test API requests

Using the API

Create an application password

Create an application password needed to communicate with the API

Incident Management API examples

Some examples of how the Incident API can be used

Change Management API examples

Some examples of how the Change API can be used

FIQL queries

Using FIQL queries

This section will show you how to use FIQL queries

Reporting API

Overview

This tutorial will walk you through setting up and accessing the Reporting API to query data from TOPdesk.

Configure permissions and filters

Set up required permissions and filters to work with Reporting API

Create reports in BI tool

Get OData feed from TOPdesk in Microsoft Power BI