語意理解接口


語意理解

1475118416259629.jpg

#微信開放平台語意瞭解介面呼叫(http請求)簡單方便,使用者無需掌握語意理解及相關技術,只需根據自己的產品特點,選擇對應的服務即可建構一套智慧語意服務。

發送語意理解請求

#http請求方式: POST(請使用https協議)

https://api.weixin.qq.com/semantic/semproxy/search?access_token=YOUR_ACCESS_TOKEN

#POST資料格式:JSON

POST資料範例:

#{

"query":"查一下明天從北京到上海的南航機票",

##"city":"北京",

"category": "flight ,hotel",

"appid":"wxaaaaaaaaaaaaaaaa",#

"uid":"123456"

#} 

#

參數說明

#access_token
參數是否必須參數類型##說明
###########access_token############是###String根據appid和appsecret取得到的token
queryString#輸入文字字串
category#String是需要使用的服務類型,多個用“,”隔開,不能為空
#latitude請參閱介面協定文件Float緯度座標,與經度同時傳入;與城市二選一傳入
longitude
#### #########請參閱介面協定文件###############Float#####################經度座標,與緯度同時傳入;與城市二選一傳入##################city############見介面協議文件###String城市名稱,與經緯度二選一傳入
region見介面協定文件#String區域名稱,在城市存在的情況下可省;與經緯度二選一傳入
#appid
##String######公有號碼唯一標識,用於區分公眾號開發者#################### #uid####String使用者唯一id(非開發者id),使用者區分公眾號下的不同使用者(建議填入使用者openid),如果為空,則無法使用上下文理解功能。 appid和uid同時存在的情況下,才可以使用上下文來理解功能。
#

註:單類別意圖比較明確,識別的覆蓋率比較大,所以如果只要使用特定某個類別,建議將category只設定為該類別。

回傳說明正常情況下,微信會傳回下述JSON封包:

「errcode」:0, 

「query」:」查一下明天從北京到上海的南航機票」, 

“type”:”flight”, 

##“semantic”:{ 

    “details”:{

        “start_loc”:{ 

            “type”:”LOC_CITY”, ## ”, 

            “city_simple”:”北京”, 

        # 

            }, 

#        「end_loc」: { 

#

            “type”:”LOC_CITY”, 

            “city”:”上海市”,# #cmple# > :”上海”, 

            “loc_ori”:”上海” 

          }, 

「start_date」: { 

            “type”:”DT_ORI”, 

       

##            「date_ori」:」明天」 

          }, ##南方航空公司” 

    }, 

#「intent」:」SEARCH」 

#}

#

傳回參數說明

errcode
參數是否必須參數類型##說明
###是###Int表示請求後的狀態
queryString#使用者的輸入字串
type#String服務的全域類型id,詳見協定文件中垂直服務協定定義
semanticObject#語意理解後的結構化標識,各服務不同
result#Array 部分類別的結果
answerString部分類別的結果html5展示,目前不支援
textString特殊回覆說明

更多詳細內容與協定說明,請查看:語意瞭解介面協定文件

##