Preview only show first 10 pages with watermark. For full document please download

Polycom® Realpresence® Capture Server - Appliance Edition

   EMBED


Share

Transcript

API GUIDE Software 1.0 | Date July 2013 | 3725-69899-001Rev A Polycom® RealPresence® Capture Server Appliance Edition Copyright ©2013, Polycom, Inc. All rights reserved. 6001 America Center Drive San Jose, CA 95002 USA No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Polycom, Inc. Under the law, reproducing includes translating into another language or format. As between the parties, Polycom, Inc., retains title to and ownership of all proprietary rights with respect to the software contained within its products. The software is protected by United States copyright laws and international treaty provision. Therefore, you must treat the software like any other copyrighted material (e.g., a book or sound recording). Every effort has been made to ensure that the information in this manual is accurate. Polycom, Inc., is not responsible for printing or clerical errors. Information in this document is subject to change without notice. Trademarks POLYCOM®, the Polycom logo and the names and marks associated with Polycom products are trademarks and/or service marks of Polycom, Inc. and are registered and/or common law marks in the United States and various other countries. All other trademarks are property of their respective owners. No portion hereof may be reproduced or transmitted in any form or by any means, for any purpose other than the recipient's personal use, without the express written permission of Polycom. Disclaimer While Polycom uses reasonable efforts to include accurate and up-to-date information in this document, Polycom makes no warranties or representations as to its accuracy. Polycom assumes no liability or responsibility for any typographical or other errors or omissions in the content of this document. Limitation of Liability Polycom and/or its respective suppliers make no representations about the suitability of the information contained in this document for any purpose. Information is provided “as is” without warranty of any kind and is subject to change without notice. The entire risk arising out of its use remains with the recipient. In no event shall Polycom and/or its respective suppliers be liable for any direct, consequential, incidental, special, punitive or other damages whatsoever (including without limitation, damages for loss of business profits, business interruption, or loss of business information), even if Polycom has been advised of the possibility of such damages. End User License Agreement Use of this software constitutes acceptance of the terms and conditions of the Polycom RealPresence Capture Server - Appliance Edition end-use license agreement (EULA). The EULA for your version is available on the Polycom Support page for the Polycom RealPresence Capture Server Appliance Edition. Customer Feedback We are striving to improve our documentation quality and we appreciate your feedback. Email your opinions and comments to [email protected]. Visit the Polycom Voice Support Center for software downloads, product documents, product licenses, troubleshooting tips, service requests, and more. ii Contents About This Guide ........................................................................ 1 Communicating with API ................................................................................................................. 1 1: API Operations ........................................................................ 2 Template Operations ................................................................................................ 3 createTemplate ................................................................................................................................. 3 deleteTemplate.................................................................................................................................. 4 updateTemplate ................................................................................................................................ 4 getTemplates ..................................................................................................................................... 5 getTemplate ....................................................................................................................................... 5 VRR Operations ........................................................................................................ 6 createVRR .......................................................................................................................................... 6 deleteVRR .......................................................................................................................................... 6 updateVRR ........................................................................................................................................ 7 getAllVRRs ........................................................................................................................................ 7 getVRR ............................................................................................................................................... 7 System Operations ................................................................................................... 8 getVersion ......................................................................................................................................... 8 getDownloadToken........................................................................................................................... 8 getEncryptedWords.......................................................................................................................... 8 enableUserPortal .............................................................................................................................. 8 disableUserPortal ............................................................................................................................. 9 getUserPortalStatus ......................................................................................................................... 9 Media Operations ...................................................................................................... 9 getArchives ....................................................................................................................................... 9 getArchiveByID ............................................................................................................................... 10 getArchivesCount ........................................................................................................................... 10 getArchivesByIndex ....................................................................................................................... 10 getArchivesByTime ........................................................................................................................ 11 getArchivesByIDs ........................................................................................................................... 11 getArchiveIDsByTime..................................................................................................................... 12 getArchiveIDsByVrrID .................................................................................................................... 12 getArchiveByCallID ........................................................................................................................ 12 updateArchive ................................................................................................................................. 13 deleteArchive .................................................................................................................................. 13 getLiveStreams ............................................................................................................................... 13 getLiveStreamingByCallID ............................................................................................................. 14 getCalls ............................................................................................................................................ 14 getCallsByStatus ............................................................................................................................ 14 getCallByID ...................................................................................................................................... 15 Recording Operations ............................................................................................ 15 startCall ........................................................................................................................................... 15 startRecording ................................................................................................................................ 15 pauseRecording.............................................................................................................................. 16 resumeRecording ........................................................................................................................... 16 stopRecording ................................................................................................................................ 16 stopCall ............................................................................................................................................ 17 startCallWithNotify ......................................................................................................................... 17 Transcoding ............................................................................................................ 17 startTranscode ................................................................................................................................ 17 restartTranscode ............................................................................................................................ 18 stopTranscode ................................................................................................................................ 18 Playback Operation ................................................................................................ 19 startPlayback .................................................................................................................................. 19 pause................................................................................................................................................ 19 play ................................................................................................................................................... 19 getCurrentPosition ......................................................................................................................... 20 seek .................................................................................................................................................. 20 2: Data Objects of API ............................................................... 21 Object Tables .......................................................................................................... 21 Template .......................................................................................................................................... 21 VRR .................................................................................................................................................. 22 Archive ............................................................................................................................................. 23 ArchiveFile ...................................................................................................................................... 23 LiveStreaming ................................................................................................................................. 24 StreamingInfo.................................................................................................................................. 25 StreamingAddress .......................................................................................................................... 25 MediaServerType ............................................................................................................................ 25 StreamProtocolType....................................................................................................................... 26 Call ................................................................................................................................................... 26 CallStatus ........................................................................................................................................ 26 TranscodeForm............................................................................................................................... 27 PlaybackInfo .................................................................................................................................... 28 Enumeration Table .................................................................................................. 28 Layout List ....................................................................................................................................... 28 Rate List ........................................................................................................................................... 29 Transcoding Configuration ........................................................................................................... 29 3: FAQs ...................................................................................... 30 How to get WSDL .................................................................................................... 30 SOAP Request Example ......................................................................................... 30 SOAP Response Example ...................................................................................... 31 How to download media file ................................................................................... 31 How to use Pin-code ............................................................................................... 31 Appendix A – APIs in old version ............................................ 32 API Operations ........................................................................................................ 32 getVersion ....................................................................................................................................... 33 getTemplates ................................................................................................................................... 33 getTemplate ..................................................................................................................................... 33 createChannel ................................................................................................................................. 33 editChannel ..................................................................................................................................... 34 deleteChannel ................................................................................................................................. 34 getChannels .................................................................................................................................... 34 createVRR ........................................................................................................................................ 35 editVRR ............................................................................................................................................ 35 deleteVRR ........................................................................................................................................ 35 getVRRs ........................................................................................................................................... 35 getVRR ............................................................................................................................................. 36 startCall ........................................................................................................................................... 36 endCall ............................................................................................................................................. 37 getCalls ............................................................................................................................................ 37 getCallsByStatus ............................................................................................................................ 37 getCall .............................................................................................................................................. 38 getNumberOfarchives .................................................................................................................... 38 getarchives ...................................................................................................................................... 38 getarchivesByCallIds ..................................................................................................................... 38 getLiveStreamings.......................................................................................................................... 39 getDownloadToken......................................................................................................................... 39 getHashedPassword ...................................................................................................................... 39 API Data Objects ..................................................................................................... 39 Template .......................................................................................................................................... 39 TemplateStreamConfig .................................................................................................................. 40 Channel ............................................................................................................................................ 40 VRR .................................................................................................................................................. 40 Call ................................................................................................................................................... 41 Media ................................................................................................................................................ 41 MediaStream ................................................................................................................................... 42 Appendix B WSDL Files ........................................................... 43 CaptureServer_Media.wsdl .................................................................................................... 43 RPCaptureServer_Playback.wsdl.......................................................................................... 79 CaptureServer_Profile.wsdl .................................................................................................... 85 About This Guide The RealPresence Capture Server Web Service API enables you to programmatically manage the Capture Server. This document assumes that you are familiar with the Capture Server and the functionality available on the Capture Server’s Web UI. (The API provides a subset of that functionality.) This document also assumes familiarity with web services in general, and with the programming language you will be using. To follow the last version device (RSS™ 4000). There are two version API services in the RealPresence Capture Server. The old version’s API point to the one in RSS 4000 version 7.0 or below, please refer to Appendix A. The other is point to API in RSS 4000 V8.0 or higher, we recommend you to use API Operations depicted in this document. Communicating with API The core messaging technology for the Capture Server API is Simple Object Access Protocol (SOAP), which is an XML- and HTTP-based protocol with wide support in the industry. The Capture Server API uses document/literal style SOAP 1.1. To use the API, write a client program in the programming language that you are familiar with. We have tested Java. Write your client program to send a request to one of the operations, such as the startCall or getarchives. The relevant operation will process the request and send back a response, which your client program needs to parse. The only software you need to install to use the API is the software for the programming language and toolkit that you will be using to write your client programs. For example, if you intend to write your client programs in Java, you will need to install the Java Development Kit and also a SOAP toolkit such as Apache CXF. The operations provided by a web service are defined in a WSDL (Web Services Definition Language) file which is posted on the web service's website. To connect to a web service, you need to know the URL for the WSDL. For the Capture Server API services, the URL for the WSDL is: https://[SERVER_HOST]:8443/rss/services/ProfileExtService?wsdl https://[SERVER_HOST]:8443/rss/services/MediaExtService?wsdl https://[SERVER_HOST]:8443/rss/services/ PlaybackService?wsdl. 1: API Operations Service URL Operation Profile Service https://[SERVER_HOST]: createTemplate; 8443/rss/services/Profile deleteTemplate; ExtService updateTemplate; getTemplates; getTemplate; createVRR; deleteVRR; updateVRR; getAllVRRs; getVRR; Media manager https://[SERVER_HOST]: getVersion; 8443/rss/services/Media getArchives; ExtService getArchiveByID; getArchivesByTime; getArchivesCount; getArchivesByIndex; updateArchive; deleteArchive; getLiveStreams; getAllCalls; startCall; startRecording; resumeRecording; pauseRecording; stopRecording; stopCall; startTranscode; restartTranscode; stopTranscode; getDownloadToken; getEncryptedWords; startCallWithNotify; enableUserPortal; disableUserPortal; getUserPortalStatus; Playback manager https://[SERVER_HOST]: 8443/rss/services/Playba ckService startPlayback; pause; play; getCurrentPosition; seek; Template Operations createTemplate Create a new template. Parameters template Template Template object Response long template ID. Exception RssExceptio n NULL_VALUE_ERROR Template object is NULL. TEMPLATE_NAME_DUPLICA TE The template name is duplicated with other. TEMPLATE_NAME_NULL Template name is empty. TEMPLATE_RATE_INVALID Invalid rate value: max rate must be equal or greater than primary rate; primary rate must be greater than second rate. TEMPLATE_ADD_FAIL Server internal error occurred. deleteTemplate delete a template by template ID Parameters templateID long Template id Response boolean Delete result. If true, it means delete successfully. Exception RssException TEMPLATE_NOT_FOUND Template is not found. TEMPLATE_DELETE_FAIL Server internal error occurred. updateTemplate Update a template. Parameters template Template Template object Response boolean Update result. If true, it means update successfully. Exception RssException NULL_VALUE_ERROR Template object is NULL. TEMPLATE_NAME_NUL L Template name is empty. TEMPLATE_RATE_INVA LID Invalid rate value: max rate must be equal or greater than primary rate; primary rate must be greater than second rate. TEMPLATE_NAME_DUP LICATE The template name is duplicated with other. TEMPLATE_NOT_FOUN D Template is not found. TEMPLATE_UPDATE_F AIL Server internal error occurred. getTemplates Get all templates. Parameters (none) Response List