WebEx 一键集成 1 文档目的...1 2 Web 集成...1 2.1 URL API 语法...1 2.2 启会...2 2.3 加会...3 2.4 调用...3 3 移动集成...3 3.1 wbx schema...3 3.2 调用...4 4 取得 sessionticket...4 1 文档目的 本文档目的是, 让用户了解如何在 Web 端和移动端, 一键调用 WebEx app, 快捷的把 WebEx 和用户的应用集成起来 2 Web 集成 可以通过 WebEx URL API 在 Web 端进行一键快速集成, 一键启会, 一键加会 WebEx URL API 提供一种基于浏览器 (HTTPS) 对 WebEx 的操作, 你可以在浏览器地址栏中直接执行 URL API 注意, 安排会议, 你可以调用 XML API 来安排会议 2.1 URL API 语法 URL AP 的语法为 https://sitename.webex.com/sitename/function.php?at=command &commandargument sitename : 你帐号的 WebEx 的站点名 function : 这个 API 的 funtion page,url api 把按照功能分为几个 php
page 功能 比如 meeting 相关的功能都集中在 m.php command : 是这个 funciton 下面的子功能 比如 start meeting 就是 HM commandargument : URL 格式的多个 API 参数 注意 get 格式只是为了方便说明格式,WebEx 因为安全原因, 要求密码的 API 只能 使用 POST 方式 请参照如下代码提交 ( 请用相应的值替换 %% 变量 ): <html> <body> <form action="https://%sitename%.webex.com.cn/%sitename%/p.php" method="post"> <input name="at" Type="text" value="li" size=30 /> <input name="wid" Type="text" value="%username%" size=30 /> <input name="pw" Type="text" value="%password%" size=30 /> <input name="mu" Type="text" value=https://%sitename%.webex.com.cn/%sitename%/m.php?at=hm &MK=%MeetingNumber% size=75 /> <input type="submit" text="submit" /> <form> </body> </html> 2.2 启会 你可以在浏览器上执行下面的 url 来实现启会 https://test.webex.com.cn/test/p.php?at=li&wid=webexid&pw=password&mu=https%3a %2f%2ftest.webex.com.cn%2ftest%2fm.php%3fAT%3dHM%26MK%3d189644419 webexid: 你的 webex 帐号 password: 你的帐号密码 MU: 是用前面帐号登录后的的加会命令, 格式是下面 url 的 URL encode 编码 https://test.webex.com.cn/test/m.php?at=hm&mk= 189644419 MK: 你相要开会的会议号 meeting key, 这个会议好你安排会议后应该会得到的
2.3 加会 如果你不是 meeting 主持人, 你可以通过调用下面 JM(Join Meeting)API 加入会议 m.php?at=jm &MK=MeetingKey [&AN=AttendeeName] [&AE=AttendeeEmail] MK: 会议号 meeting key AN 和 AE: 加会时候需要输入的参加者姓名和邮件, 可选, 如果在 API 里面填写了, 加会时 就不需要再输入了 例子 https://test.webex.com.cn/test/m.php?at=jm&mk=189644419&an=test&ae=test@163.com 2.4 集成调用 你可以在 web 端浏览器上, 当用户点击相应按钮后, 在浏览器上执行上面的 URL, 上面 URL 将打开 WebEx 客户端进行开会, 这样就可以在 Web 端实现一键集成 3 移动集成 可以通过 wbx schema 在移动端实现一键启会, 和一键加会 3.1 wbx schema Android 启会 wbx://meeting/sitename.webex.com.cn/sitename?mk=meetingkey&mtgtk=& sitetype=train&r2sec=1 &UN=%webexID&TK=%sessionTicket IOS 启会 wbx://sitename.webex.com.cn/sitename?mk=meetingkey&mtgtk=&sitetype =TRAIN&r2sec=1 &ST=1&UN=%webexID&TK=%sessionTicket Android 加会 wbx://meeting/sitename.webex.com.cn/sitename?mk=meetingkey&mtgtk=& sitetype=train&r2sec=1
IOS 加会 wbx://sitename.webex.com.cn/sitename?mk=meetingkey&mtgtk=&sitetype =TRAIN&r2sec=1 &ST=1 sitename : 你帐号的 WebEx 的站点名 meetingkey: 会议号 meeting key webexid: 你的 webex 帐号, 需要用 URLEncoder 加密, 如 URLEncoder.encode(webexID) sessionticket: 验证你用户的 ticket, 可以通过 URL API, 或者 XML API 获取 ( 参考第 4 章节 ), 需要用 URLEncoder 加密, 如 URLEncoder.encode(sessionTicket) 其中加会的格式也可以简化 Android 用 wbx://meeting?mk=111&mpw=111 IOS 用 wbx://cisco.webex.com/cisco?mk=345678123 3.2 集成调用 比如在 Android 端调用, 可以在用户按下按钮后, 执行下面的代码 Intent intent = new Intent(Intent.ACTION_VIEW); intent.setdata(uri.parse(url)); activity.startactivityforresult(intent,webexinvokerequest); 执行后, 系统就会调用 Webex app 进入会议 实现一键集成 4 取得 sessionticket 这一节是对上面移动集成取 sessionticket 的详细补充 你可以通过 URL API 两步获得 sessionticket(post 方式提交 ) 第一步, 取加密后的密码 https://sitename.webex.com.cn/sitename/user.php?at=getauthinfo&un=webexid&pw=pa ssword&getencryptedpwd=true 返回的加密密码字符串 第二步, 取 sessionticket https://sitename.webex.com.cn/sitename/user.php?at=getauthinfo&un=webexid&epw=e ncryptedpassword&isutf8=1 返回的是 xml 文档, 取 <?xml version="1.0" encoding="utf-8"?> <AuthInfo> <Result>SUCCESS</Result> <UserName>jason</UserName>
<UserID>12732</UserID> <FirstName>jason</FirstName> <LastName>chen</LastName> <SessionTicket>AAAB </SessionTicket> </AuthInfo> 取其中的 SessionTicket URL 中参数解释如下 webexid: 你的 webex 帐号 password: 你的 webex 密码 encryptedpassword: 你第一步加密取到的加密后的 webex 密码