Getting Started

ManageEngine Desktop Central now facilitates easy integration with your existing infrastructure using REST APIs. You can perform various desktop management activities easily from a single console.You can find the list of modules for which APIs are available in the side bar, if you need more APIs you can contact us with your requirement.

This document describes prerequisites for using the API.

API - URI Structure

All API URI must be structured in the following format,

<Server URL>/api/{Version}/{Entity}/{Operation|Action}/<Resource>/<Filter>/<Page tags>/<Search tags>
  • Tags
  • Optional/Mandatory
  • Description
  • Usage
  • Version
  • Mandatory
  • API Version
  • 1.0 ie current API Version
  • Entity
  • Mandatory
  • The module for API
  • e.g. inventory, som, desktop
  • Operation or Action
  • Mandatory
  • Operation or action in the module
  • e.g. computers, computers/installagents
  • Resource
  • Optional
  • Resource ID for the operation
  • e.g. resid={resourceID}
  • Page tags
  • Optional
  • Page to fetch, and number of objects per page
  • page={page}&pagelimit={PageLimit}

    e.g:
    page=1&pagelimit=50

    Requests for first 50 objects.
  • Search tags
  • Optional
  • Results with specified column matching search string
  • searchtype={resources}&searchcolumn={columnname}&searchvalue={searchvalue}

    e.g.:
    searchtype=domain_name&searchcolumn=domain_name&searchvalue=Zohocorp

    Currently the api requires searchtype to be set same as searchcolumn value.

Authentication

Auth token is required for accessing our API. To obtain auth token follow these steps.

Authentication API Endpoint

/api/1.0/desktop/authentication

1(a). Generate Token through local authentication

Send POST request with HTTP header Content-Type:application/json and following JSON in request body to the authentication API.

 { 
"username":"Username",
"password":"base 64 encoded password",
"auth_type":"local_authentication"
}

1(b). Generate Token through AD Authentication

Domain Names can be fetched fetched from server discover api. Send GET request in the following format to the authentication API.

GET 

/api/1.0/desktop/authentication

?username=<Username>

&password=<Password base64 encoded>

&auth_type=ad_authentication

&domainName=<Domain name>
      

2. Obtain Auth Token from the response

{     "message_response": {         "authentication": {             "user_data": {                 "user_name": "admin",                 "phone_number": null,                 "email": "",                 "auth_type": "Local Authentication",                 "user_id": 1             },             "user_permissions": {                 "admin": ["SOM_Admin", ],                 "write": ["SOM_Write", "Tools_Write"],                 "read": ["SOM_Read", "Tools_Read"]             },             "auth_data": {                 "auth_token": "B42550F3-006D-48EB-8011-F6C7D6323EE7"             }         }     },     "status": "success",     "message_version": "1.0",     "message_type": "authentication" }

3. Set Auth Token to request header

Set the authtoken from to Authorization HTTP header for all requests.

For a token B42550F3-006D-48EB-8011-F6C7D6323EE7 set header as

Authorization:B42550F3-006D-48EB-8011-F6C7D6323EE7

Customer Information

Customer ID is required for accessing our API. To obtain customer ID, follow these steps.

Customer Information API URI

/api/1.0/desktop/customers

2. Obtain customer information from the response

{     "message_response": {         "authentication": {             "user_data": {                 "user_name": "admin",                 "phone_number": null,                 "email": "",                 "auth_type": "Local Authentication",                 "user_id": 1             },             "user_permissions": {                 "admin": ["SOM_Admin", ],                 "write": ["SOM_Write", "Tools_Write"],                 "read": ["SOM_Read", "Tools_Read"]             },             "auth_data": {                 "auth_token": "B42550F3-006D-48EB-8011-F6C7D6323EE7"             }         }     },     "status": "success",     "message_version": "1.0",     "message_type": "authentication" }

3. Set customer ID to API request

Set the customer ID in all the requests, to access any API in Desktop Central MSP.