产品概述 简介 图灵机器人API是在人工智能的核心能力（包括语义理解、智能问答、场景交互、知识管理等）的基础上，为广大开发者、合作伙伴和企业提供的一系列基于云计算和大数据平台的在线服务和开发接口。 开发者可以利用图灵机器人的API创建各种在线服务，灵活定义机器人的属性、编辑机器人的智能问答内容，打造个人专属智能交互机器人，也支持多渠道（微信公众平台、QQ聊天）的快速接入。 产品特色 图灵机器人是国内第一家个性化智能机器人开放平台，为广大开发者提供智能机器人API端口。图灵机器人基于DeepQA深度问答技术，对中文的识别准确率高达90%，是目前中文语境下智能度最高的机器人。图灵机器人具有高智能、一键接入、个性化、跨平台四大特点，通过图灵机器人开放平台，任何人都可以方便快捷的为微信公众号、微博、QQ群、WEB网站、智能客服系统以及智能家居系统、智能车载系统等软硬件领域接入一位聪明的图灵机器人。 功能介绍 智能对话、知识库、技能服务是图灵机器人三大核心功能。智能对话是指，图灵机器人可赋予软硬件产品中文自然语言交互的能力；知识库是指图灵机器人用户可为机器人导入独家内容以满足个性化及商业化需要；技能服务是指，图灵机器人打包提供超500种实用生活服务技能，涵盖生活、出行、学习、金融、购物等多个领域，一站式满足用户需求。 应用场景 图灵机器人应用广泛，目前已应用于实体机器人，如家用服务机器人、儿童陪伴机器人等，虚拟机器人，如智能客服系统、微信公众号、QQ机器人、APP应用等，智能家居控制系统、智能车载等领域。已为超18万合作方提供技术支持。 使用说明 使用流程 注册申请图灵帐号 登录图灵机器人官方网站 http://www.tuling123.com/ ，点击右上角“注册”按钮进行注册并激活帐号，如下图所示： 获取APIKEY 每一个激活用户都可以通过图灵机器人开放平台获取多个APIKEY（当前每个用户可最多获取5个APIKEY），用户可以根据自己的需要获取不同的图灵APIKEY来应用于多种场景，获取成功后就等于拿到了开启图灵服务的钥匙。 登录图灵帐号，进入个人中心，在“我的机器人》机器人详情》接入”页面即可看到每一个机器人的API KEY，如下图所示： 接口地址 http://www.tuling123.com/openapi/api 请求方式 HTTP POST 注：若之前使用get请求方式，仍能继续使用,日后将对该请求方式不再进行更新及维护工作，建议采用post请求方式。 请求参数 请求参数格式为json 请求示例： ~~~ { “key”: “APIKEY”, “info”: “今天天气怎么样”， “loc”：“北京市中关村”， “userid”：“123456” } ~~~ 参数 是否必须 长度 示例 说明 key 必须 32 1ca8089********736b8ce41591426(32位) 注册之后在机器人接入页面获得（参见本文档第2部分） info 必须 1-30 打招呼“你好” 查天气“北京今天天气” 请求内容，编码方式为UTF-8 userid 上下文【1】 儿童版 必须 1-32 abc123（支持0-9，a-z,A-Z组合，不能包含特殊字符） 开发者给自己的用户分配的唯一标志（对应自己的每一个用户） 注：【1】图灵机器人在天气、航班、列车等场景下支持上下文，下面以航班查询为例 示例： { “key”: “APIKEY”, “info”: “北京到上海的飞机”， “userid”：“12345678” } 信息不完整时，当使用userid参数，可进入上下文语境。 图灵机器人：亲爱的，您准备哪天去上海？ { “key”: “APIKEY”, “info”: “明天”， “userid”：“12345678” } 图灵机器人：亲，已帮你找到航班信息（并给出对应url） loc 非必须 1-30 北京市中关村 江西省南昌市 位置信息，请求跟地理位置相关的内容时使用，编码方式UTF-8 儿童版 userid 获取策略 自定义唯一 userid（1-32位，字母与数字组成） 返回数据格式 Code 说明 100000 文本类 200000 链接类 302000 新闻类 308000 菜谱类 313000（儿童版） 儿歌类 314000（儿童版） 诗词类 注：儿歌类，诗词类两个功能目前只对儿童版API开放 文字类 (1)请求示例 ~~~ { “key”:“APIKEY”, “info”:“你好” } ~~~ (2)返回数据 ~~~ { "code":100000, "text":"你也好 嘻嘻" } ~~~ (3)数据说明 | 字段 | 说明| | --- | --- | | code | 文本类标识码 | | trext | 结果 | 链接类 (1)请求示例 ~~~ { “key”: “APIKEY”, “info”: “小狗的图片” } ~~~ (2)返回数据 { "code": 200000, "text": "亲，已帮你找到图片", "url": "http://m.image.so.com/i?q=%E5%B0%8F%E7%8B%97" } (3)数据说明 字段 说明 code 链接类标识码 text 提示语 url 链接地址 新闻类 (1)请求示例 { “key”: “APIKEY”, “info”: “我想看新闻” } (2)返回数据 { "code": 302000, "text": "亲，已帮您找到相关新闻", "list": [ { "article": "工信部:今年将大幅提网速降手机流量费", "source": "网易新闻", "icon": "", "detailurl": "http://news.163.com/15/0416/03/AN9SORGH0001124J.html" }, { "article": "北京最强沙尘暴午后袭沪 当地叫停广场舞", "source": "网易新闻", "icon": "", "detailurl": "http://news.163.com/15/0416/14/ANB2VKVC00011229.html" }, { "article": "公安部:小客车驾照年内试点自学直考", "source": "网易新闻", "icon": "", "detailurl": "http://news.163.com/15/0416/01/AN9MM7CK00014AED.html" } ] } (3)数据说明 字段 说明 code 新闻类标识码 text 提示语 list 信息列表 article 新闻标题 source 新闻来源 icon 新闻图片 detailurl 新闻详情链接 列车类 (1)请求示例 { “key”: “APIKEY”, “info”: “北京到拉萨的火车” } (2)返回数据 { "code": 200000, "text": "亲，已帮你找到列车信息", "url": "http://touch.qunar.com/h5/train/trainList?startStation=%E5%8C%97%E4%BA%AC&endStation=%E6%8B%89%E8%90%A8&searchType=stasta&date=2015-12-25&sort=3&filterTrainType=1&filterTrainType=2&filterTrainType=3&filterTrainType= 4&filterTrainType=5&filterTrainType=6&filterTrainType=7&filterDeptTimeRa" } (3)数据说明 字段 说明 code 链接类标识码 text 提示语 url 链接地址 航班类 (1)请求示例 { “key”: “APIKEY”, “info”: “明天北京到拉萨的飞机” } (2)返回数据 { "code": 200000, "text": "亲，已帮您找到航班信息", "url": "http://touch.qunar.com/h5/flight/flightlist?bd_source=chongdong&startCity=%E5%8C%97%E4%BA%AC&destCity=%E6%8B%89%E8%90%A8&startDate=2015-12-25&backDate=&flightType=oneWay&priceSortType=1" } (3)数据说明 字段 说明 code 链接类标识码 text 提示语 url 链接地址 菜谱类 (1)请求示例 { “key”: “APIKEY”, “info”: “鱼香肉丝怎么做” } (2)返回数据 { "code": 308000, "text": "亲，已帮您找到菜谱信息", "list": [{ "name": "鱼香肉丝", "icon": "http://i4.xiachufang.com/image/280/cb1cb7c49ee011e38844b8ca3aeed2d7.jpg", "info": "猪肉、鱼香肉丝调料 | 香菇、木耳、红萝卜、黄酒、玉米淀粉、盐", "detailurl": "http://m.xiachufang.com/recipe/264781/" }] } (3)数据说明 字段 说明 code 菜谱类标识码 text 提示语 name 菜名 info 菜谱信息 detailurl 详情链接 icon 信息图标 儿歌类 注：该功能仅限儿童版使用 (1)请求示例 { “key”: “APIKEY”, “info”: “给我唱一首刘德华的忘情水”, “userid”：“自定义唯一 userid（1-32位，字母与数字组成）” } (2)返回数据 { "code": 313000, "text": "开始播放音乐。", "function": { "song": "刘德华", "singer": "忘情水" } } (3)数据说明 字段 说明 code 儿歌类标识码 text 提示语 song 歌曲名 singer 歌手 诗词类 注：该功能仅限儿童版使用 (1)请求示例 { “key”: “APIKEY”, “info”: “背一首李白的望庐山瀑布” , “userid”：“自定义唯一 userid（1-32位，字母与数字组成）” } (2)返回数据 { "code": 314000, "text": "开始朗读诗词。", "function": { "author": "李白", "name": "望庐山瀑布" } } (3)数据说明 字段 说明 code 诗词类标识码 text 提示语 author 作者 name 诗词名 返回异常码 异常返回示例 { "code":*****, "text":"相应提示语" } 异常码说明 异常码（code） 说明 40001 参数key错误 40002 请求内容info为空 40004 当天请求次数已使用完 40007 数据格式异常 加密操作 用户须知 （1）请求方式必须为HTTP POST； （2）需在个人中心“我的机器人》机器人详情》接入”（微信公众号除外）开启加密功能secret，开启之后原HTTP GET请求将被禁止； （3）加密示例demo可在个人中心“我的机器人》机器人详情》接入”（微信公众号除外）中下载文档获取。 调用说明 请求地址 http://www.tuling123.com/openapi/api 请求方式 HTTP POST 编码方式 UTF-8（调用图灵API的各个环节的编码方式均为UTF-8） 加密算法规则 参数说明 （1）时间戳用户校验请求，请尽可能的准确 （2）在图灵官网个人中心”我的机器人》机器人详情》接入“页获取APIKey，secret（默认为关闭状态，使用需打开），计算当前的时间戳 示例如下： secret = 123 timestamp = 456789 apiKey = key 生成密钥 （1）说明：MD5为32位算法，生成的aesKey为全小写keyParam = secret+timestamp+apiKey （2）对keyParam进行MD5（32位算法）加密，生成aesKey，对“123456789key”进行加密之后得到aesKey = 912194e51267870e9283e9a035360a78; 执行AES加密 （1）说明：AES采用128位加密算法请求参数，例如： param = {"info":"你好"} （2）通过上面生成的aesKey,对请求参数param进行AES加密，得到data data = TwPFGlIQk/yl2qDbNyuSQg9JMeV6aLdCS7yo6lT5Ia0= 封装请求图灵API的json参数 { key:key, timestamp:456789, data:TwPFGlIQk/yl2qDbNyuSQg9JMeV6aLdCS7yo6lT5Ia0= }