微信公眾平台自定義選單介面API指南

2022-02-18 13:02:33 字數 3147 閱讀 7122

開發實現方法,請檢視 

開發者獲取使用憑證(如何獲取憑證)後,可以使用該憑證對公眾賬號的自定義選單進行建立、查詢和刪除等操作。 自定義選單介面可實現以下型別按鈕:

click(點選事件):

介面說明

請求說明

http請求方式:post

請求示例

,,,

]}]}

建立後效果:

引數說明

引數是否必須

說明button

是按鈕陣列,按鈕個數應為1~3個

sub_button

否子按鈕陣列,按鈕個數應為1~5個

type

是按鈕型別,目前有click型別

name

是按鈕描述,既按鈕名字,不超過16個位元組,子選單不超過40個位元組

key型別為click必須

按鈕key值,用於訊息介面(event型別)推送,不超過128位元組

返回說明

正確的json返回結果:

錯誤的json返回結果

統一返回碼說明

介面說明

查詢當前使用的自定義選單結構。

請求說明

http請求方式:get

返回說明

對應建立介面,正確的json返回結果:

,,,]}]}}

統一返回碼說明

介面說明

取消當前使用的自定義選單。

請求說明

http請求方式:get

返回說明

對應建立介面,正確的json返回結果:

統一返回碼說明

請先確保公眾賬號已經擁有介面呼叫許可權。

預設每個公眾帳號都不能超過下面的頻率限制。 當超出呼叫介面頻率限制,呼叫對應介面將會收到如下錯誤資訊:

介面名稱

頻率限制

獲取憑證介面

200(次/天)

自定義選單建立介面

100(次/天)

自定義選單查詢介面

1000(次/天)

自定義選單刪除介面

100(次/天)

返回碼說明

-1系統繁忙

0請求成功

40001

驗證失敗

40002

不合法的憑證型別

40003

不合法的openid

40004

不合法的**檔案型別

40005

不合法的檔案型別

40006

不合法的檔案大小

40007

不合法的**檔案id

40008

不合法的訊息型別

40009

不合法的檔案大小

40010

不合法的語音檔案大小

40011

40012

不合法的縮略**件大小

40013

40014

不合法的access_token

40014

不合法的access_token

40015

不合法的選單型別

40016

不合法的按鈕個數

40017

不合法的按鈕個數

40018

不合法的按鈕名字長度

40019

不合法的按鈕key長度

40020

不合法的按鈕url長度

40021

不合法的選單版本號

40022

不合法的子選單級數

40023

不合法的子選單按鈕個數

40024

不合法的子選單按鈕型別

40025

不合法的子選單按鈕名字長度

40026

不合法的子選單按鈕key長度

40027

不合法的子選單按鈕url長度

40028

不合法的自定義選單使用使用者

41001

缺少access_token引數

41002

41003

缺少refresh_token引數

41004

缺少secret引數

41005

缺少多**檔案資料

41006

缺少media_id引數

41007

缺少子選單資料

42001

access_token超時

43001

需要get請求

43002

需要post請求

43003

需要https請求

44001

多**檔案為空

44002

post的資料報為空

44003

**訊息內容為空

45001

多**檔案大小超過限制

45002

訊息內容超過限制

45003

標題字段超過限制

45004

描述字段超過限制

45005

鏈結字段超過限制

45006

鏈結字段超過限制

45007

45008

**訊息超過限制

45009

介面呼叫超過限制

45010

建立選單個數超過限制

46001

不存在**資料

46002

不存在的選單版本

46003

不存在的選單資料

47001

解析json/xml內容錯誤

源**:

微信公眾平台自定義選單

介面呼叫請求說明 http請求方式 get引數說明 引數是否必須 說明grant type 是獲取access token填寫client credential 是第三方使用者唯一憑證 secret 是返回說明 引數 說明access token 獲取到的憑證 expires in 憑證有效時間,單...

微信公眾平台 自定義選單

服務號和通過認證的訂閱號可以申請自定義選單。自定義選單介面可實現click view兩種型別的按鈕。1 建立選單 const createmenuurl function createmenus accesstoken string tjsonobject var url string j tjso...

PHP微信公眾平台自定義選單

請求說明 http請求方式 get 現在你的token已經獲取成功了,下來就是相關的 實現了。public function createmenu ch curl init curl setopt ch,curlopt url,curl setopt ch,curlopt customrequest...