產品概述 簡介 圖靈機器人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= }