Cisco Cisco TelePresence Management Suite (TMS) Version 15 Developer's Guide

Each call made to the  Cisco TMSBA must include the following header specifying the version of the API. The 
value specified in 

ClientVersionIn

 is used by the API to determine the output from the function. The XML 

below describes the ExternalAPIVersionSoapHeader object that is common for all calls to the API.

Do not set a number greater than the latest version of the API, as this may break compatibility when using 
later revisions.

<ExternalAPIVersionSoapHeader

 

xmlns

="http://tandberg.net/2004/02/tms/external/booking/"

>

 

<ClientVersionIn>

int

</ClientVersionIn>

 

<ClientIdentifierIn>

string

</ClientIdentifierIn>

 

<C

lientLatestNamespaceIn>

string

</ClientLatestNamespaceIn>

 

<NewServiceURL>

string

</NewService

URL>

 

</ExternalAPIVersionSoapHeader>

If no version number is set, version 0 is the default. 

Two flags control whether an email confirmation of the request will be sent out, and whether the confirmation 
will include conference information such as routing, list of participating systems, and so on. 

<ContextHeader

 

xmlns

="http://tandberg.net/2004/02/tms/external/booking/"

>

 

<SendConfirmati

onMail>

boolean

</SendConfirmationMail>

 

<ExcludeConferenceInformation>

boolean

</ExcludeConfe

renceInformation>

 

</ContextHeader>

The flags are not mandatory, and both are false by default. 

Cisco TMSBA Programming Reference Guide

Page 16 of 68

Using the APIs for remote setup and booking