ADDER AdderLink Infinity Manager User Manual

 sll




40
Appendix D
AIM API
The AIM API provides access for external applications to key routines used within
the AIM server. This appendix provides a reference to the available methods.
API version: 2
Changelog
• v2(AIMv2.3)-addedget_devices, get_channels, connect_channel,
disconnect_channel. Updated version compatibility information.
• v1(AIMv1.3)-addedlogin, logout, get_presets, connect_preset,
disconnect_preset
Methods
login (http://<aim.ip.address>/api/#login)
logout (http://<aim.ip.address>/api/#logout)
get_devices (http://<aim.ip.address>/api/#get_devices)
get_channels (http://<aim.ip.address>/api/#get_channels)
get_presets (http://<aim.ip.address>/api/#get_presets)
connect_channel (http://<aim.ip.address>/api/#connect_channel)
connect_preset (http://<aim.ip.address>/api/#connect_preset)
disconnect_channel (http://<aim.ip.address>/api/#disconnect_channel)
disconnect_preset (http://<aim.ip.address>/api/#disconnect_preset)
login
This method was last updated in API version 1, and is compatible with API
requests from version 1 onwards.
The API will require a valid AIM user’s login credentials to be presented in the
first request. The API will return an authentication code, which must be passed
in all future requests. This authentication code can be re-used until a logout
request is made, at which point the authentication code will no longer be valid.
The concept of an ‘anonymous user’ can apply to the API. If no login username
and password are provided, the API will return an authentication token for the
anonymous user (either the same one as for the OSD, or else an ‘anonymous API
user’ account can be created).
Input parameters:
- username
- password
- v (the AIM API version this request is designed for)
Output values:
- timestamp - the current server time
- version - the current API version number
- token - an authentication code for future API requests
- success
Examples
Input:
/api/?v=1&method=login&username=xxxxx&password=xxxxx
Output:
<api_response>
<version>1</version>
<timestamp>2012-12-1412:12:12</timestamp>
<success>1</success>
<token>5cf494a71c29e9465a57a81e0a2d602c</token>
</api_response>
or
<api_response>
<version>1</version>
<timestamp>2012-12-1412:12:12</timestamp>
<success>0</success>
<errors>
<error>
<code>2</code>
<msg>Invalidusernameorpassword</msg>
</error>
</errors>
</api_response>

ADDER AdderLink Infinity Manager Specifications

General

Certification	CE, FCC
Mounting type	Rack mounting
Product color	Black
Control display unit	No
Operating temperature (T-T)	0 - 40 °C
Power supply	60 W
Input current	1.5 A
Input voltage	100 - 240 V
Output voltage	12 V
Input frequency	50/60 Hz
Ethernet LAN (RJ-45) ports	2

Weight and Dimensions

Depth	230 mm
Width	432 mm
Height	44 mm
Weight	2750 g