W3Cschool
恭喜您成為首批注冊用戶
獲得88經(jīng)驗值獎勵
本接口將會提供公眾號當(dāng)前使用的自定義菜單的配置,如果公眾號是通過API調(diào)用設(shè)置的菜單,則返回菜單的開發(fā)配置,而如果公眾號是在公眾平臺官網(wǎng)通過網(wǎng)站功能發(fā)布菜單,則本接口返回運營者設(shè)置的菜單配置。
請注意:
1、第三方平臺開發(fā)者可以通過本接口,在旗下公眾號將業(yè)務(wù)授權(quán)給你后,立即通過本接口檢測公眾號的自定義菜單配置,并通過接口再次給公眾號設(shè)置好自動回復(fù)規(guī)則,以提升公眾號運營者的業(yè)務(wù)體驗。 2、本接口與自定義菜單查詢接口的不同之處在于,本接口無論公眾號的接口是如何設(shè)置的,都能查詢到接口,而自定義菜單查詢接口則僅能查詢到使用API設(shè)置的菜單配置。 3、認(rèn)證/未認(rèn)證的服務(wù)號/訂閱號,以及接口測試號,均擁有該接口權(quán)限。 4、從第三方平臺的公眾號登錄授權(quán)機制上來說,該接口從屬于消息與菜單權(quán)限集。 5、本接口中返回的圖片/語音/視頻為臨時素材(臨時素材每次獲取都不同,3天內(nèi)有效,通過素材管理-獲取臨時素材接口來獲取這些素材),本接口返回的圖文消息為永久素材素材(通過素材管理-獲取永久素材接口來獲取這些素材)。
接口調(diào)用請求說明
http請求方式: GET(請使用https協(xié)議)https://api.weixin.qq.com/cgi-bin/get_current_selfmenu_info?access_token=ACCESS_TOKEN
返回結(jié)果說明
如果公眾號是在公眾平臺官網(wǎng)通過網(wǎng)站功能發(fā)布菜單,則本接口返回的自定義菜單配置樣例如下:
{ "is_menu_open": 1, "selfmenu_info": { "button": [ { "name": "button", "sub_button": { "list": [ { "type": "view", "name": "view_url", "url": "http://www.qq.com" }, { "type": "news", "name": "news", "value":"KQb_w_Tiz-nSdVLoTV35Psmty8hGBulGhEdbb9SKs-o", "news_info": { "list": [ { "title": "MULTI_NEWS", "author": "JIMZHENG", "digest": "text", "show_cover": 0, "cover_url": "http://mmbiz.qpic.cn/mmbiz/GE7et87vE9vicuCibqXsX9GPPLuEtBfXfK0HKuBIa1A1cypS0uY1wickv70iaY1gf3I1DTszuJoS3lAVLvhTcm9sDA/0", "content_url": "http://mp.weixin.qq.com/s?__biz=MjM5ODUwNTM3Ng==&mid=204013432&idx=1&sn=80ce6d9abcb832237bf86c87e50fda15#rd", "source_url": "" }, { "title": "MULTI_NEWS1", "author": "JIMZHENG", "digest": "MULTI_NEWS1", "show_cover": 1, "cover_url": "http://mmbiz.qpic.cn/mmbiz/GE7et87vE9vicuCibqXsX9GPPLuEtBfXfKnmnpXYgWmQD5gXUrEApIYBCgvh2yHsu3ic3anDUGtUCHwjiaEC5bicd7A/0", "content_url": "http://mp.weixin.qq.com/s?__biz=MjM5ODUwNTM3Ng==&mid=204013432&idx=2&sn=8226843afb14ecdecb08d9ce46bc1d37#rd", "source_url": "" } ] } }, { "type": "video", "name": "video", "value": "http://61.182.130.30/vweixinp.tc.qq.com/1007_114bcede9a2244eeb5ab7f76d951df5f.f10.mp4?vkey=77A42D0C2015FBB0A3653D29C571B5F4BBF1D243FBEF17F09C24FF1F2F22E30881BD350E360BC53F&sha=0&save=1" }, { "type": "voice", "name": "voice", "value": "nTXe3aghlQ4XYHa0AQPWiQQbFW9RVtaYTLPC1PCQx11qc9UB6CiUPFjdkeEtJicn" } ] } }, { "type": "text", "name": "text", "value": "This is text!" }, { "type": "img", "name": "photo", "value": "ax5Whs5dsoomJLEppAvftBUuH7CgXCZGFbFJifmbUjnQk_ierMHY99Y5d2Cv14RD" } ] } }
如果公眾號是通過API調(diào)用設(shè)置的菜單,自定義菜單配置樣例如下:
{ "is_menu_open": 1, "selfmenu_info": { "button": [ { "type": "click", "name": "今日歌曲", "key": "V1001_TODAY_MUSIC" }, { "name": "菜單", "sub_button": { "list": [ { "type": "view", "name": "搜索", "url": "http://www.soso.com/" }, { "type": "view", "name": "視頻", "url": "http://v.qq.com/" }, { "type": "click", "name": "贊一下我們", "key": "V1001_GOOD" } ] } } ] } }
參數(shù)說明
<tr class="firstRow thead"<th class="table_cell"">說明
參數(shù) | |
is_menu_open | 菜單是否開啟,0代表未開啟,1代表開啟 |
selfmenu_info | 菜單信息 |
button | 菜單按鈕 |
type | 菜單的類型,公眾平臺官網(wǎng)上能夠設(shè)置的菜單類型有view(跳轉(zhuǎn)網(wǎng)頁)、text(返回文本,下同)、img、photo、video、voice。使用API設(shè)置的則有8種,詳見《自定義菜單創(chuàng)建接口》 |
name | 菜單名稱 |
value、url、key等字段 | 對于不同的菜單類型,value的值意義不同。官網(wǎng)上設(shè)置的自定義菜單: |
Text:保存文字到value; Img、voice:保存mediaID到value; Video:保存視頻下載鏈接到value; News:保存圖文消息到news_info,同時保存mediaID到value; View:保存鏈接到url。 | |
使用API設(shè)置的自定義菜單: click、scancode_push、scancode_waitmsg、pic_sysphoto、pic_photo_or_album、 pic_weixin、location_select:保存值到key;view:保存鏈接到url | |
news_info | 圖文消息的信息 |
title | 圖文消息的標(biāo)題 |
digest | 摘要 |
author | 作者 |
show_cover | 是否顯示封面,0為不顯示,1為顯示 |
cover_url | 封面圖片的URL |
content_url | 正文的URL |
source_url | 原文的URL,若置空則無查看原文入口 |
Copyright©2021 w3cschool編程獅|閩ICP備15016281號-3|閩公網(wǎng)安備35020302033924號
違法和不良信息舉報電話:173-0602-2364|舉報郵箱:jubao@eeedong.com
掃描二維碼
下載編程獅App
編程獅公眾號
聯(lián)系方式:
更多建議: