创建会议

 xunzhong.createMeeting 

打破通话只能局限于2方的界限,可以满足3方以上同时通话。

优先必读
1 用户账户Id(accountSID)和用户账户授权令牌(authToken)在哪获取?
提示 用户登录平台,在导航菜单管理-控制台-开发者主账号下面
或用户登录平台,在导航菜单管理-体验-功能体验-账号信息下面。(两种获取到账户信息是一样的)
2 应用ID在哪获取?
提示 1.如果使用沙箱环境http://sandbox.ytx.net,用户登录平台,在导航菜单管理-体验-功能体验-测试应用下面。
2.如果使用正式环境http://api.ytx.net,用户登录平台,在导航菜单管理-应用管理-应用列表下,若没有应用,需要创建应用。(注:应用上线后,应用ID才有效)
3 状态回推的相关设置?
提示 (注:沙箱环境http://sandbox.ytx.net,没有相关设置)
在使用正式环境http://api.ytx.net下,用户登录平台,在导航菜单管理-应用管理-创建应用-设置相应的回调地址。
4 IP鉴权地址的相关配置?
提示 (注:沙箱环境http://sandbox.ytx.net,没有相关设置)
在使用正式环境http://api.ytx.net下,用户登录平台,在导航菜单管理-应用管理-创建应用-设置相应的IP白名单。
(注:如测试使用ip白名单,切记将测试主机ip加入到白名单中)
有需要对用户接口发送的服务器进行ip限制,就可以使用ip鉴权进行配置。多个ip使用英文,号分隔。配置空表示不鉴权。
5 签名sign的加密格式是什么?
提示 MD5加密(账户Id + 账户授权令牌 +时间戳),例如:Sign=AAABBBCCCDDDEEEFFFGGG *时间戳需与Authorization中时间戳相同(时间戳格式:yyyyMMddHHmmss) 注:MD5加密32位,无论大小写
6 应用验证失败原因(-205)与解决办法?
提示 1.应用ID与环境不匹配:
①体验里应用ID与沙箱环境http://sandbox.ytx.net使用
②自己创建的应用的应用ID与正式环境http://api.ytx.net使用
2.设置ip白名单:
①去掉白名单在测试 ②将测试主机ip加入到白名单中
3.应用未开通相应的功能或应用没有上线。
公共参数
请求地址:
环境 HTTP请求地址
正式环境 http://api.ytx.net
沙箱环境 http://sandbox.ytx.net
公共请求参数:
名称 类型 是否必须 描述
accountSID string 云通信平台用户账户Id:对应管理控制台中的 ACCOUNT SID
authToken string 云通信平台用户账户授权令牌:对应管理控制台中的 AUTH TOKEN
version string 云通信API接口版本 目前可选版本:201612
func string 功能所属分类call【语音类】/sms【消息类】/traffic【流量类】/account【账户类】 当前功能属:call
funcURL string 业务功能的各类具体操作分支 当前功能属:TeleMeeting.wx
Authorization string 云通信平台API接口,包头验证信息:base64加密(账户Id + "|" + 时间戳) 说明:时间戳有效时间为24小时 格式"yyyyMMddHHmmss",如:20140416142030
Sign string 云通信平台API接口,API 验证参数 :MD5加密(账户Id + 账户授权令牌 +时间戳) *URL后必须带有Sign参数,例如:Sign=AAABBBCCCDDDEEEFFFGGG *时间戳需与Authorization中时间戳相同 注:MD5加密32位,无论大小写
请求参数:
名称 类型 是否必须 描述
action string API接口名称,默认值:createMeeting (区分大小写)
appid string 用户登录云通信平台后,所创建的应用的编号appid,若想调用当前模板短信接口,则此应用必须包含有模板短信功能,否则调用失败。
meetingname string 会议室名称
creator string 用于标记会议的发起人电话号码(例:188****7016)
parties string 参加会议人员的名称和电话号码,也可以是名称和固话+分机号,固话和分机号用逗号','隔开 (例: [{"name":"zhangsan","phone":"188****6401"},{"name":"wangwu","phone":"01053889900,1234"}])
bookmeeting string 会议状态,0:立即开会 1:预约开会 2:取消预约
confid string 当前会议室编号,如果是编辑预约会议室填写创建会议室返回值meid,如不是填写""
booktime datetime 预约时间,如果是预约会议室必须填写,不是填写""
shownumber string 外显号码不传为默认的外显号码(传的外显号码需相关人员配置)
CustomParm string 用户自定义参数 (主要可用为商户传给平台的唯一订单编号,本平台不校验订单唯一性,该参数在回调此订单状态时返回)
响应参数:
名称 类型 示例值 描述
statusCode string 0 发送结果错误码
statusMsg string {"meid":"002","mepwd":"896433",meetcallerid:"01053189900"} 当前会议室信息(meid会议室编号,mepwd会议室密码,meetcallerid会议室外显号码)
requestId string 2016010000000219 为验证码发送成功后返回的requestId唯一标识
请求包头:
1 URL
2 /{version}/sid/{accountSID}/{func}/{funcURL}?Sign={Sign}
3 HTTP标准包头字段
4 Accept:application/json;
5 Content-Type:application/json;charset=utf-8;
6 Authorization:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
报文示例:
JSON提示:
1 POST /201612/sid/abcdefghijklmnopqrstuvwxyz012345/call/TeleMeeting.wx?Sign=C1F20E7A9733CE94F680 C70A1DBABCDE HTTP/1.1
2 Host:127.0.0.1:46376
3 content-length: 142
4 Accept:application/json;
5 Content-Type:application/json;charset=utf-8;
6 Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3M
jAwN2M6MjAxMzAyMDExNTABCDE=
7 {"action":"createMeeting","appid":"ff8080813fc70a7b013fc72312324213",
"meetingname":"123cs","creator":"136****7556",
"parties":"[{"name":"张三","phone":"150****0804"},
{"name":"李四","phone":"136****7556"}]",
"bookmeeting":"0","confid":"","booktime":""}
请求示例:
.Net
1 立即开会:
string jsonData = "{ \"action\":\"createMeeting\",
\"appid\":\"ff8080813fc70a7b013fc72312324213\",
\"meetingname\":\"123cs\",
\"creator\":\"136****7556\",
\"parties\":\"[{\"name\":\"张三\",\"phone\":\"150****0804\"},
{\"name\":\"李四\",\"phone\":\"136****7556\"}]\",
\"bookmeeting\":\"0\",\"confid\":\"\",\"booktime\":\"\"}";
2 预约会议:
string jsonData = "{\"action\":\"createMeeting\",
\"appid\":\"ff8080813fc70a7b013fc72312324213\",
\"meetingname\":\"123cs\",
\"creator\":\"136****7556\",
\"parties\":\"[{\"name\":\"张三\",\"phone\":\"150****0804\"},
{\"name\":\"李四\",\"phone\":\"136****7556\"}]\",
\"bookmeeting\":\"1\",
\"confid\":\"\",\"booktime\":\"2017-03-03 17:10\"}";
3 编辑预约会议:
string jsonData = "{\"action\":\"createMeeting\",
\"appid\":\"ff8080813fc70a7b013fc72312324213\",
\"meetingname\":\"123cs\",
\"creator\":\"136****7556\",
\"parties\":\"[{\"name\":\"张三\",\"phone\":\"150****0804\"},
{\"name\":\"李四\",\"phone\":\"136****7556\"}]\",
\"bookmeeting\":\"1\",\"confid\":\"002\",\"booktime\":\"2017-03-03 17:10\"}";
4 string url = "/call/TeleMeeting.wx";
5 string result = CommenHelper.SendRequest(url, jsonData);
6 备注: SendRequest方法在CommenHelper.cs文件里做了封装。详细介绍请点击这里完整demo示例下载
响应示例
JSON示例
1 HTTP/1.1 200 OK
2 Content-Length: 85
3 {"statusCode":"0","statusMsg":{"meid": "002","mepwd": "896433","meetcallerid": "01053189900"}}
异常示例
JSON示例
1 HTTP/1.1 200 OK
2 Content-Length: 61
3 {"statusCode":"-2","statusMsg":"缺少必要参数","requestId":""}
为了不影响使用体验性,请选择谷歌或者火狐浏览器登录!