语义开放平台 API 规范文档
语义开放平台
API 规范文档
II
语义开放平台 API 规范文档
版权声明
版权所有 © 2015,科大讯飞股份有限公司,保留所有权利。
商标说明
科大讯飞股份有限公司的产品是科大讯飞股份有限公司专有。在提及其他公司及
其产品时将使用各自公司所拥有的商标,这种使用的目的仅限于引用。本文档可
能涉及科大讯飞股份有限公司的专利(或正在申请的专利)、商标、版权或其他
知识产权,除非得到科大讯飞股份有限公司的明确书面许可协议,本文档不授予
使用这些专利(或正在申请的专利)、商标、版权或其他知识产权的任何许可协
议。
不作保证声明
科大讯飞股份有限公司不对此文档中的任何内容作任何明示或暗示的陈述或保
证,而且不对特定目的的适销性及适用性或者任何间接、特殊或连带的损失承担
任何责任。本文档内容若有变动,恕不另行通知。本文档例子中所用的公司、人
名和数据若非特别声明,均属虚构。未得到科大讯飞股份有限公司明确的书面许
可,不得为任何目的、以任何形式或手段(电子的或机械的)复制或传播文档的
任何部分。
保密声明
本文档(包括任何附件)包含的信息是保密信息。接收人了解其获得的本文档是
保密的,除用于规定的目的外不得用于任何目的,也不得将本文档泄露给任何第
三方。本软件产品受最终用户许可协议(EULA)中所述条款和条件的约束,该
协议位于产品文档和/或软件产品的联机文档中,使用本产品,表明您已阅读并
接受了EULA 的条款。
版权所有© 科大讯飞股份有限公司
Copyrights © iFLYTEK CO., LTD.
科大讯飞语义开放平台
III
语义开放平台 API 规范文档
目录
1. 概述......................................................................................................................... 1
2. 协议......................................................................................................................... 1
2.1 应答消息格式 ............................................................................................................... 1
2.2 应答消息字段定义 ....................................................................................................... 2
2.2.1 应答码 ............................................................................................................... 2
2.2.2 错误定义 ........................................................................................................... 3
2.2.3 语义结构化表示 ............................................................................................... 3
2.2.4 结构化数据表示 ............................................................................................... 3
2.2.5 HTML5 页面表示 .............................................................................................. 4
2.2.6 简化图文结果表示 ........................................................................................... 4
2.2.7 moreResults 结构表示 ...................................................................................... 5
3. 通用功能协议......................................................................................................... 6
3.1 地点描述相关协议 ....................................................................................................... 6
3.1.1 基础地点(表示行政区划)的 location ........................................................ 6
3.1.2 表示道路的 location ........................................................................................ 6
3.1.3 表示交叉路口的 location ................................................................................ 7
3.1.4 表示区域的 location ........................................................................................ 8
3.1.5 表示位置点的 location .................................................................................... 8
3.1.6 其他说明 ........................................................................................................... 9
3.2 时间描述相关协议 ....................................................................................................... 9
3.2.1 基础描述(表示时间点)的 datetime ........................................................... 9
3.2.2 表示时间段的 datetime ................................................................................. 10
3.2.3 无法解析的时间说法的 datetime ................................................................. 11
4. 通用服务............................................................................................................... 12
4.1 应用 ............................................................................................................................. 14
4.2 百科 ............................................................................................................................. 16
4.3 计算器 ......................................................................................................................... 17
4.4 菜谱 ............................................................................................................................. 18
4.5 日期 ............................................................................................................................. 20
4.6 社区问答 ..................................................................................................................... 21
4.7 航班查询 ..................................................................................................................... 22
4.8 酒店查询 ..................................................................................................................... 24
4.9 地图查询 ..................................................................................................................... 26
4.10 音乐 ............................................................................................................................. 28
4.11 电台查询 ..................................................................................................................... 30
4.12 餐馆 ............................................................................................................................. 31
4.13 提醒 ............................................................................................................................. 33
4.14 股票查询 ..................................................................................................................... 35
4.15 火车查询 ..................................................................................................................... 37
科大讯飞语义开放平台
IV
语义开放平台 API 规范文档
4.16 翻译 ............................................................................................................................. 39
4.17 电视节目预告 ............................................................................................................. 40
4.18 视频 ............................................................................................................................. 44
4.19 天气查询 ..................................................................................................................... 47
4.20 网页搜索 ..................................................................................................................... 49
4.21 登录网站 ..................................................................................................................... 50
4.22 微博 ............................................................................................................................. 51
4.23 鲜花 ............................................................................................................................. 55
4.24 礼品 ............................................................................................................................. 57
4.25 短租房 ......................................................................................................................... 59
4.26 褒贬 ............................................................................................................................. 61
4.27 问候 ............................................................................................................................. 62
4.28 情绪 ............................................................................................................................. 63
4.29 打电话 ......................................................................................................................... 64
4.30 发短信 ......................................................................................................................... 66
4.31 空气质量 ..................................................................................................................... 69
4.32 闲聊 ............................................................................................................................. 70
附录 I 系统级错误信息表.......................................................................................... 71
附录 I.I 业务通用语义错误信息表......................................................................... 71
附录 II 火车座位对照表............................................................................................. 71
附录 III 火车车次对照表 ........................................................................................... 72
附录 IV 国家名称简称 ............................................................................................... 72
附录 V 语言名称简称 ................................................................................................ 74
科大讯飞语义开放平台
1
语义开放平台 API 规范文档
1. 概述
科大讯飞语义开放平台,是一套集语义解析、智能问答、垂直搜索和业务接入于一体的
技术接入平台。面向广大开发者和微信运营服务提供商提供一站式语义解决方案,大数据分
析平台更是为应用提供了精准的运营数据。
该平台覆盖多垂直领域的语义通用场景,提供海量通用问答资源,支持亿万量级词典的
复杂语义空间建模,以及自定义文法和通用文法的混合解码。同时支持 Andriod、IOS、JAVA、
Linux 等多终端形式接入,通过多样化的结果输出,满足应用的个性化定制需求。
语义开放平台通过扁平化的交互设计,用户无需掌握语义的具体相关技术,只需根据自
身产品特性,选择通用语义场景和问答库,即可快速拥有语义解析和智能问答服务。
2. 协议
2.1 应答消息格式
交互成功时的 JSON 内容示例:
{
“rc”:0,
“text”:”红烧肉怎么做”,
“service”: ”cookbook”,
“operation”:”SEARCH”,
“semantic”: {
"slots": {
"name": "红烧肉"
}
},
“data“: {
“header”:”红烧肉的做法”,
“result”:[ { “accessory”: "桂皮:1根八角:3棵...",
“cuisine”: "",
“url”: “http://www....”,
……
},
……
]
},
“tips”:“周边的美食”
}
科大讯飞语义开放平台