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

Page of 67
Usage requirements
This section describes the licensing, permission, and authentication requirements for using the APIs.
Licensing
One of the following licenses must be available to make full use of Cisco TelePresence Management Suite 
Booking API:
 
One Cisco TMS Application Integration License for each server using the API.
 
One Cisco TelePresence Management Suite Booking API license per 25 registered systems.
The following API functions require one of the above licenses:
 
GetRecordingAliases
 
GetTransactionsSince
 
SaveConference
 
SaveConferenceRecInstance
 
SaveConferences
The remaining API features do not require special licensing for use. Contact your Cisco reseller/partner for 
more licensing information.
Booking rights
Importing from Cisco TMS and booking meetings through the API requires authentication with Cisco TMS. 
There are two possible models for user authentication.
Service user books on behalf of users
The simplest approach is configuring one service user in Cisco TMS for your client, and granting this user 
Book on behalf of permissions as described below.
This model is only appropriate if all users with access to the client can be granted the same permissions in 
Cisco TMS, as booking on behalf of someone will create a new Cisco TMS user in the default group if the 
user does not already exist.
All users book for themselves
If you need to set up different booking rights per user, or block some users from booking altogether, each user 
must authenticate with Cisco TMS individually through the API.
Setting up permissions
All users who will book meetings using the API must be members of a group whose permissions include 
Booking. Users who book on behalf of others also require Book on behalf of permissions. 
Permissions in Cisco TMS are set on a group level. To modify the permissions set for a group:
Cisco TMSBA Programming Reference Guide (14.3)
Page 13 of 67
Using the APIs for remote setup and booking