REST APIs

IDrive EVS REST APIs: Development now made easy!

Get server address

Retrieve your IDrive server address using getServerAddress API. Use this address for executing REST APIs and command line utility APIs.

It is important to note that the IDrive server address is dynamic and may change over a period of time as physically the data may get moved to another server. So depending on your application needs, you may need to call this API periodically to get the current IDrive server address applicable for the user.

Quick links

Syntax for 'getServerAddress' API:

https://evs.idrive.com/evs/getServerAddress

HTTP method: POST
Input parameters:
uid username or email address
pwd password

Output:
Below is a sample XML output generated during server address display:
<tree message="SUCCESS" cmdUtilityServer="evs1.idrive.com" cmdUtilityServerIP="173.255.12.86" webApiServer="evsweb1.idrive.com" webApiServerIP="173.255.12.87"/>

The output contains Command line utility server address and its corresponding IP address. You may choose server address or IP address while executing command line utility APIs.

command line utility server address: cmdUtilityServer="evs1.idrive.com"
command line utility server IP address: cmdUtilityServerIP="173.255.12.86"

Similarly, for REST APIs execution you may choose server address or IP address.


REST API server address: webApiServer="evsweb1.idrive.com"
REST API server IP address: webApiServerIP="173.255.12.87
"

Description:
  • tree
    Root node with attributes; message and desc.
  • message
    This attribute describes whether the operation was SUCCESS or ERROR.
  • desc
    This attribute holds error(s) generated during an invalid operation.

Following cases explain the expected outputs during INVALID operations:
  • Case 1: Empty Username or Password
    <tree message="ERROR" desc="INVALID PARAMETERS"/>
  • Case 2: Invalid Username or Password
    <tree message="ERROR" desc="INVALID USER"/> Or
    <tree message="ERROR" desc="INVALID PASSWORD"/>

Code snippets for Java, PHP, Python and Ruby:

Java:

PHP:

Python:

Ruby: