Cisco Meeting Server - API概要 シスコシステムズ合同会社 テクニカルソリューションズアーキテクト 岩岸 優希 2016年9月 @yiwagish ブログ:http://cs.co/yiwagish
えー、なんでAPI なの? 開発者じゃないのに。。。。
API(アプリケーションんプログラミングインターフェース) 設定ツール
API による設定の優位性 機能実装のスピード感 顧客体験の自由度
何ができるのか?というより、いつ必要なのか? Spaceごとのデフォルトレイアウト Webから変更可能
何ができるのか?というより、いつ必要なのか? CMAでレイアウト Web/アプリで変更可能
何ができるのか?というより、いつ必要なのか? ビデオ端末からレイアウト変更
何ができるのか?というより、いつ必要なのか? ビデオ端末からレイアウト変更 シスコ端末 + TelePresence Server or CMR Cloud > アクティブコントロール (IX Protocol)で変更可能 2.0 未対応
何ができるのか?というより、いつ必要なのか? ビデオ端末からレイアウト変更 シスコ端末 + TelePresence Server or CMR Cloud > DTMF 2 / 8 で変更可能 デフォルトではDisable
How can I change screen layouts using DTMF? https://kb.acano.com/content/33/257/en/how-can-i-change-screen-layouts- using-dtmf.html
Cisco Meeting Server API
REST (Webの仕組みと同じ)
HTMLの話
HTTPの話
RESTの話 Meeting Server /calls CMS XML XML Meeting Server XML Data
RESTの中身
Chrome Advanced Rest Client ブラウザのプラグインで”設定” 履歴が残るので Postmanが運用では おすすめ Firefox Poster Chrome Postman Chrome Advanced Rest Client APIガイドには Firefox Poster利用例 DevNet ラーニングガイドにはChrome Postman入門ガイド多数
Firefox Poster (入門的に)
Cisco Meeting Server API
DTMFによるレイアウト変更 - 3 Step API ユーザの作成 DTMF Profile作成 Call Leg Profile作成 System Profile に割り当て DTMFに対してのアクション 通話中のプロファイル システムレベルのプロファイル
acano> user add apiuser api Please enter new password: ユーザの作成 acano> user add apiuser api Please enter new password: Please enter new password again: Success
Firefox-Poster利用
GET : 情報の取得=ID情報 POST : 新規設定=新規ID作成 PUT:設定変更=IDに変更を加える RESTの基本 GET : 情報の取得=ID情報 POST : 新規設定=新規ID作成 PUT:設定変更=IDに変更を加える DELETE:設定削除=IDを削除
POST Method DTMF Profile作成 https://URL/api/v1/dtmfProfiles 新規作成はPOST nextLayout=8 次のレイアウトは”8”
DTMF Profile作成 200 OK Location dtmfProfile IDをメモ
PUT MethodでDTMF Profile更新 https://URL/api/v1/dtmfProfiles/ID 更新はPUT previousLayout=2 前のレイアウトは”2”
DTMF Profile作成 GET Methodで確認
callLegProfiles作成 Call Leg Profile作成 https://URL/api/v1/callLegProfiles 新規作成はPOST changeLayoutAllowed=true レイアウト変更を有効に
Call Leg Profile作成 200 OK Location CallLegProfile IDをメモ
https://URL/api/v1/system/profiles System Profile に割り当て PUT: システムプロファイル更新 https://URL/api/v1/system/profiles システムプロファイル常にPUT callLegProfile=ID
https://URL/api/v1/system/profiles System Profile に割り当て PUT: システムプロファイル更新 https://URL/api/v1/system/profiles システムプロファイル常にPUT dtmfProfiles=ID
同じdtmfProfileで実装できるもの ミュート制御 録画 会議ロック 会議終了 同じdtmfProfileで実装できるもの muteSelfAudio unmuteSelfAudio toggleMuteSelfAudio muteAllExceptSelfAudio unmuteAllExceptSelfAudio startRecording stopRecording muteAllNewAudio unmuteAllNewAudio defaultMuteAllNewAudio muteAllNewAndAllExceptSelfAudio unmuteAllNewAndAllExceptSelfAu dio lockCall unlockCall endCall
https://URL/api/v1/xxx APIリスト /accessQuery /callBrandingProfiles /callBridges /calls /callProfiles /callLegs /callLegProfiles /coSpaceBulkParameterSets /coSpaceBulkSyncs /coSpaces dialTransforms /directorySearchLocations /dtmfProfiles /forwardingDialPlanRules inboundDialPlanRules /ivrs /ivrBrandingProfiles /ldapMappings
https://URL/api/v1/xxx APIリスト /ldapServers ldapSources /ldapSyncs /outboundDialPlanRUles /participants /recorders /system/ /tenants /turnServers /users /userProfiles /webBridges
APIが必要な機能 FAQ How do I enforce encryption for a space? https://kb.acano.com/content/10/70/en/how-do-i-enforce-encryption-for-a- space.html Can I create multiple IVRs? https://kb.acano.com/content/7/179/en/can-i-create-multiple-ivrs.html Can members of a space control other participants' audio or video? https://kb.acano.com/content/14/204/en/can-members-of-a-space-control- other-participants_-audio-or-video.html
RESTは今後も必要になりますので。。。 developer.cisco.com Learning Lab https://learninglabs.cisco.com/lab/04-rest-01-overview-of-rest-apis/step/1