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

Page of 81
Setting up your environment
Cisco TMSBA provides a Web Services API that interfaces with the Cisco TMS booking engine. Web 
Services allows for simple integration into most common language and programming environments. 
See your development tool reference for information on how to build implementation stubs to help speed the 
development of applications that use Web Services.
API locations
 
n
The WSDL file for the Cisco TMS remote setup API is located at: http://[Cisco TMS server]
/tms/external/booking/remotesetup/remotesetupservice.asmx
 
n
The WDSL file for Cisco TMSBA is located at: http://[Cisco TMS server]
/tms/external/booking/bookingservice.asmx
Microsoft Visual Studio .NET users can reference the APIs by selecting 
Project > Add Web Reference
, or 
entering the URLs above. You will be required to authenticate through web services to create the reference. 
In a network load balancing scenario, use the virtual IP address or DNS name of the cluster for this task to 
allow failover for the API.
Security
We strongly recommend using SOAP for all requests. For security reasons, HTTP GET and POST are only 
accessible from localhost. To change this, modify the Cisco TMS web.config file.
Optional elements
Optional elements are indicated in different ways in the WSDL:
 
n
minOccurs = 0
 means the element can be omitted from the request XML altogether.
 
n
nillable="true"
 means the element can hold an empty value. 
The combination of these two is an element that can be skipped and be set to null (not a value).
Boolean values
The boolean lexical forms "1" and "true" are interchangeable in SOAP.
Cisco TelePresence Management Suite Extension Booking API Programming Reference Guide (14.6)     
Page 18 of 81
Using the APIs for remote setup and booking
Setting up your environment