語意理解接口
語意理解
#微信開放平台語意瞭解介面呼叫(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 |
query | 是 | String | #輸入文字字串 |
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 表示請求後的狀態 query 是 String #使用者的輸入字串 type 是 #String 服務的全域類型id,詳見協定文件中垂直服務協定定義 semantic 是 Object #語意理解後的結構化標識,各服務不同 result 否 #Array 部分類別的結果 answer 否 String 部分類別的結果html5展示,目前不支援 text 否 String 特殊回覆說明