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

API overview

Cisco TMSBA Programming Reference Guide

Page 10 of 53

When a change to the API is needed, the WSDL must be updated. The WSDL is the contract towards the 
API clients and provides information covering all methods and data types, including values, that the Booking 
API supports. 

When, for example, support for an additional bandwidth value is added to the API, the WSDL changes, and 
the version number is increased. If this new bandwidth value is added in version 9 of the API, every client 
declaring that they are using version 9 or later will get this new value returned from Cisco TMSBA. 

Clients that announce compliance to versions earlier than 9 will not get the new value returned. Instead , the 
API returns the special value default. The API allows all incoming values, but filters values going out. A client 
declaring a version lower than 9, that then enumerates a conference with the new bandwidth value,  will get 
the special value default returned. 

If the client uses this conference and updates the conference with bandwidth set to default, no change to the 
bandwidth value is made, as the API knows this special value means no changes should be made. 

This filtering of values that older clients do not understand makes the API backwards compatible; older 
clients built on older WSDLs can still use an API with a higher version.