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