Cisco Cisco TelePresence MCU 4510 Developer's Guide
XML-RPC protocol overview
Cisco TelePresence MCU Remote Management API Reference Guide
Page 8 of 89
XML-RPC protocol overview
Message flow
An application external to the MCU can create and manage conferences by sending command
messages to the MCU. For each command sent (provided the message is correctly formatted
according to the
messages to the MCU. For each command sent (provided the message is correctly formatted
according to the
), the MCU responds with a message indicating success or failure.
The response message may also contain any data that was requested.
Authentication
In order to manage the MCU, the controlling application must authenticate itself as a user with
relevant privileges. Accordingly, each command message contains a user name and password; see
the section Common message elements below for details of the format. It is worth noting that
authentication information is sent using plain text and should only be sent over a trusted network.
relevant privileges. Accordingly, each command message contains a user name and password; see
the section Common message elements below for details of the format. It is worth noting that
authentication information is sent using plain text and should only be sent over a trusted network.
Example command message
Command messages are sent in XML format. For example, the following message schedules a
conference on an MCU to begin at 10:45 on 18 February 2005 and last for one hour:
conference on an MCU to begin at 10:45 on 18 February 2005 and last for one hour:
POST /RPC2 HTTP/1.1
User-Agent: Frontier/5.1.2 (WinNT)
Host: 10.2.1.100
Content-Type: text/xml
Content-length: 713
<?xml version="1.0"?>
<methodCall>
<methodName>conference.create</methodName>
<params>
<param>
<value>
<struct>
<member>
<name>authenticationUser</name>
<value>
<string>api_test</string>
</value>
</member>
<member>
<name>authenticationPassword</name>
<value>
<string>123456</string>
</value>
</member>
<member>
<name>conferenceName</name>
<value>
<string>Meeting 1</string>
</value>
</member>
<member>
<name>startTime</name>