Black Box ACR1000A-CTL API, servswitch ipath manager api manual Connectpreset

Page 12

ServSwitch iPATH Manager API Documentation

connect_preset

This method was last updated in API version 1 and is compatible with API requests from version 1 onwards.

This simple function connects all channel-receiver pairs in a preset.

Input parameters:

-token

-v (the iPATH API version this request is designed for)

-id - the ID of the preset (acquired from get_presets)

-view_only (optional, 0/1 - defaults to 0)

-exclusive (optional, 0/1 - defaults to 0)

-force - whether to ignore errors with some of the preset's pairs or not

Output values:

-version - the current API version number

-timestamp - the current server time

-success (0 = fail, 1 = success)

-errors (optional, if anything went wrong with connecting the presets)

Examples

Input:

/api/?v=1&method=connect_preset&token=xxxxx&id=1&force=1

Output:

<api_response> <version>1</version> <timestamp>2012-12-12 12:12:12</timestamp> <success>1</success>

</api_response>

or

<api_response> <version>1</version> <timestamp>2012-12-12 12:12:12</timestamp> <success>0</success>

<errors>

<error>

<code>210</code>

<msg>A Receiver is in use by another User</msg>

</error>

</errors>

</api_response>

Page 12

724-746-5500 blackbox.com

Image 12
Contents Application Programming Interface API Manual ServSwitch iPATH Manager API Documentation Login API version ChangelogMethods Logout Getdevices Device item=4 did170/did Device item=1 did64/did Getchannels Getpresets Connectionpreset /apiresponse Connectchannel Connectpreset Disconnectpreset DisconnectchannelServSwitch iPATH Manager API Documentation Blackbox.com Black Box Tech Support FREE! Live /7