http://www.unisound.com/
云知声智能语音交互平台
语义云平台
语义解析服务协议文档
http://www.unisound.com/
修改历史
版本
日期
描述
2.1.0
2013/10/09
刘升平
对外发布的正式文档
2.1.1
2013/10/28
刘升平
1． 所有 service 都至少有一个 code
2． 添加电视操作服务
2.1.2
2013/11/20
梁家盟
1． 修正“请求有效性验证”部分关于计算 SHA1 校验值的描述
2． 添加酒店服务
2.1.3
2013/12/03
刘升平
1． 添加购物服务
2.1.4
2013/12/23
刘升平
1． 添加语音 id
2.1.5
2014/1/21
单波
1． 添加 help 服务
2.1.6
2013/2/24
刘升平
1． 请求参数：添加场景，屏幕大小和分辨率
2． 天气服务：添加 PM2.5 数据
2.1.6
2013/3/14
刘升平
1. 增加新支持的场景：电话，短信，联系人
2.1.7
2013/4/18
时培轩
1. 增加 手机充值领域
2.2.0
2013/5/12
刘升平
1. 视频领域：新加多个字段
2. 设置领域：新加多条指令
3. 电视机操作领域：新加多条指令
4. 新增领域：路况
2.2.2
2014/10/21
修改 log
http://www.unisound.com/
目录
1 概述........................................................................................................................................... 1
2 协议........................................................................................................................................... 1
2.1 请求有效性验证 ....................................................................................................... 1
2.2 应答码 ....................................................................................................................... 4
2.3 URL 请求 .................................................................................................................. 4
2.4 应答数据 ................................................................................................................... 6
2.4.1 语义表示 ................................................................................................................... 6
2.4.2 服务相关结构化数据 ............................................................................................... 7
2.4.3 通用结构化数据表示 ............................................................................................... 7
2.4.4 错误信息 ................................................................................................................... 8
3 通用服务 ................................................................................................................................... 8
3.1 闹钟 ................................................................................................................................. 10
3.2 应用 ................................................................................................................................. 11
3.3 天气 ................................................................................................................................. 13
3.4 电话 ................................................................................................................................. 17
3.5 联系人 ............................................................................................................................. 18
3.6 菜谱 ................................................................................................................................. 20
3.7 周边搜索 ......................................................................................................................... 21
3.8 酒店 ................................................................................................................................. 23
3.9 航班 ................................................................................................................................. 24
3.10 IMAX .............................................................................................................................. 26
3.11 电影 ................................................................................................................................. 29
3.12 音乐 ................................................................................................................................. 31
3.13 新闻 ................................................................................................................................. 32
3.14 备忘录 ............................................................................................................................. 33
3.15 小说 ................................................................................................................................. 34
3.16 提醒 ................................................................................................................................. 35
3.17 定位和路线 ..................................................................................................................... 36
3.18 搜索 ................................................................................................................................. 38
3.19 设置 ................................................................................................................................. 41
3.20 电视操作 ......................................................................................................................... 45
3.21 网站 ................................................................................................................................. 48
3.22 短信 ................................................................................................................................. 49
3.23 购物搜索 ......................................................................................................................... 50
3.24 股票 ................................................................................................................................. 51
3.25 火车 ................................................................................................................................. 51
3.26 翻译 ................................................................................................................................. 53
3.27 视频 ................................................................................................................................. 55
3.28 微博 ................................................................................................................................. 57
3.29 热线电话 ......................................................................................................................... 58
3.30 计算器 ............................................................................................................................. 59
3.31 聊天 ................................................................................................................................. 60
http://www.unisound.com/
3.32 日历 ................................................................................................................................. 61
3.33 电视节目 ......................................................................................................................... 62
3.34 手机充值 ......................................................................................................................... 66
3.35 路况 ................................................................................................................................. 67
3.36 帮助 ................................................................................................................................. 68
附录 I: 系统级错误信息表 .......................................................................................................... 68
http://www.unisound.com/
1
1 概述
云知声语义云平台，是一套先进的语义解析，智能问答和智能对话服务的技术接入平台。
它以自然语言理解为基础、以问答对话为最终产品形态，面向微信运营服务提供商，以及中
小微开发者，提供语义解析，智能问答和智能对话服务接入。平台目前已支持接入微信公众
号、安卓和 iOS 客户端，Web 客户端等多种终端形态。
云知声智能服务云平台操作简便。用户无需掌握语义解析和智能问答相关的具体技术，
只需要注册成为平台会员并自助申请开通服务，再结合自身产品、服务逻辑选择公共服务，
创建私有服务，就可以快速拥有一个智能的问答服务。
2 协议
本文档规定服务器与客户端之间的通讯采用 HTTP 协议，服务器同时支持接受 GET、
POST 两种 HTTP 请求类型，客户端可以根据情况进行选择。客户端对服务器的每个请
求应答超时时间约定为 60 秒，超过 60 秒，客户端可以自行决定后续操作(再次请求，
停止操作，提示用户等)。
2.1 请求有效性验证
服务器规定，客户端所有的请求必须经过签名。签名的过程是将请求参数、合法授权的
appkey 以及 secret 根据一定的签名算法生成的签名值，作为新的请求参数从而提高访问
过程中的防篡改性。签名值的生成过程如下：
1. 对除 appsig 以外的请求参数按照参数名进行字典升序排序，如：
appkey，method，text，ver；
2. 排序后，将参数名和参数值按照“参数名=参数值”(param=value)的形式组合
起来，多个请求参数之间使用&连接，如：
appkey=XXXXXXXXXXX&method=iss.getTalk&text=来一首歌曲&ver=2.0
