語(yǔ)義理解接口
語(yǔ)義理解
微信開(kāi)放平臺(tái)語(yǔ)義理解接口調(diào)用（http請(qǐng)求）簡(jiǎn)單方便，用戶(hù)無(wú)需掌握語(yǔ)義理解及相關(guān)技術(shù)，只需根據(jù)自己的產(chǎn)品特點(diǎn)，選擇相應(yīng)的服務(wù)即可搭建一套智能語(yǔ)義服務(wù)。
發(fā)送語(yǔ)義理解請(qǐng)求
http請(qǐng)求方式: POST（請(qǐng)使用https協(xié)議）
https://api.weixin.qq.com/semantic/semproxy/search?access_token=YOUR_ACCESS_TOKEN
POST數(shù)據(jù)格式：JSON
POST數(shù)據(jù)例子：
{
"query":"查一下明天從北京到上海的南航機(jī)票",
"city":"北京",
"category": "flight,hotel",
"appid":"wxaaaaaaaaaaaaaaaa",
"uid":"123456"
}
參數(shù)說(shuō)明
| 參數(shù) | 是否必須 | 參數(shù)類(lèi)型 | 說(shuō)明 |
| access_token | 是 | String | 根據(jù)appid和appsecret獲取到的token |
| query | 是 | String | 輸入文本串 |
| category | 是 | String | 需要使用的服務(wù)類(lèi)型，多個(gè)用“，”隔開(kāi)，不能為空 |
| latitude | 見(jiàn)接口協(xié)議文檔 | Float | 緯度坐標(biāo)，與經(jīng)度同時(shí)傳入；與城市二選一傳入 |
| longitude | 見(jiàn)接口協(xié)議文檔 | Float | 經(jīng)度坐標(biāo)，與緯度同時(shí)傳入；與城市二選一傳入 |
| city | 見(jiàn)接口協(xié)議文檔 | String | 城市名稱(chēng)，與經(jīng)緯度二選一傳入 |
| region | 見(jiàn)接口協(xié)議文檔 | String | 區(qū)域名稱(chēng)，在城市存在的情況下可省；與經(jīng)緯度二選一傳入 |
| appid | 是 | String | 公眾號(hào)唯一標(biāo)識(shí)，用于區(qū)分公眾號(hào)開(kāi)發(fā)者 |
| uid | 否 | String | 用戶(hù)唯一id（非開(kāi)發(fā)者id），用戶(hù)區(qū)分公眾號(hào)下的不同用戶(hù)（建議填入用戶(hù)openid），如果為空，則無(wú)法使用上下文理解功能。appid和uid同時(shí)存在的情況下，才可以使用上下文理解功能。 |
注：?jiǎn)晤?lèi)別意圖比較明確，識(shí)別的覆蓋率比較大，所以如果只要使用特定某個(gè)類(lèi)別，建議將category只設(shè)置為該類(lèi)別。
返回說(shuō)明 正常情況下，微信會(huì)返回下述JSON數(shù)據(jù)包:
{
“errcode”:0,
“query”:”查一下明天從北京到上海的南航機(jī)票”,
“type”:”flight”,
“semantic”:{
“details”:{
“start_loc”:{
“type”:”LOC_CITY”,
“city”:”北京市”,
“city_simple”:”北京”,
“l(fā)oc_ori”:”北京”
},
“end_loc”: {
“type”:”LOC_CITY”,
“city”:”上海市”,
“city_simple”:”上?！?
“l(fā)oc_ori”:”上?！?nbsp;
},
“start_date”: {
“type”:”DT_ORI”,
“date”:”2014-03-05”,
“date_ori”:”明天”
},
“airline”:”中國(guó)南方航空公司”
},
“intent”:”SEARCH”
}
返回參數(shù)說(shuō)明
| 參數(shù) | 是否必須 | 參數(shù)類(lèi)型 | 說(shuō)明 |
| errcode | 是 | Int | 表示請(qǐng)求后的狀態(tài) |
| query | 是 | String | 用戶(hù)的輸入字符串 |
| type | 是 | String | 服務(wù)的全局類(lèi)型id，詳見(jiàn)協(xié)議文檔中垂直服務(wù)協(xié)議定義 |
| semantic | 是 | Object | 語(yǔ)義理解后的結(jié)構(gòu)化標(biāo)識(shí)，各服務(wù)不同 |
| result | 否 | Array | 部分類(lèi)別的結(jié)果 |
| answer | 否 | String | 部分類(lèi)別的結(jié)果html5展示，目前不支持 |
| text | 否 | String | 特殊回復(fù)說(shuō)明 |
更多詳細(xì)內(nèi)容與協(xié)議說(shuō)明，請(qǐng)查看：語(yǔ)義理解接口協(xié)議文檔