Deprecating Older API Versions

Deprecating Older API Versions

Hi All,


All APIs provided by Desktop Central will be migrated from versions 1.0 and 1.1 to 1.2 and 1.3. Versions 1.2 and 1.3 are both supported for all API URIs, but it is recommended to use v1.3.

 

We request all our users to migrate to the newer versions as soon as possible; the older versions will become non-functional with the upcoming build releases.


The difference in structure of APIs is as follows:

Old: Server_name/api/1.0(or 1.1)/desktop/authentication

New: Server_name/api/1.2(or 1.3)/desktop/authentication

 

 The revised API documentation can be viewed here.

 

 Other enhancements in API include: 

  • Role based access: Users triggered API calls are validated in Desktop Central with the assigned privileges before being processed, in case the user doesn’t have sufficient privileges, an error response will be returned.

  • 2FA support: Desktop Central APIs now support two factor authentication to provide an extra layer of security. Refer here for more information.

  • Server information API: This API was created newly after splitting it from the Server Discover API. It ensures that server information is posted only to authenticated users.

    Structure of Server Information API:
    API Endpoint : api/1.3/desktop/serverinfo
    HTTP Method: GET
    Set the authtoken from to Authorization HTTP header for all requests.
    Response:
    {
    "message_type": "serverinfo",
    "message_response": {
    "serverinfo": {
    "server_data": {
    "product_type": "Professional",
    "base_language": "en_US",
    "license_type": "T",
    "server_ip": "192.168.141.46",
    "is_msp": false,
    "build_no": "100350",
    "jatracking_enabled": true,
    "product_name": "ManageEngine Desktop Central",
    "sec_ip": "--",
    "demo_mode": false
    }
    }
    },
    "message_version": "1.0",
    "status": "success"
    }

 

The modified structure of the Discover API can be viewed here.

Cheers,
ManageEngine Team



                New to ADSelfService Plus?