微信公眾號全域性返回碼及其說明
最近經常要查閱公眾號的錯誤返回碼,為了方便,寫下來方便以後檢視:
全域性返回碼說明
公眾號每次呼叫介面時,可能獲得正確或錯誤的返回碼,開發者可以根據返回碼資訊除錯介面,排查錯誤。
全域性返回碼說明如下:
返回碼 |
說明 |
-1 |
系統繁忙,此時請開發者稍候再試 |
0 |
請求成功 |
40001 |
獲取access_token時AppSecret錯誤,或者access_token無效。請開發者認真比對AppSecret的正確性,或檢視是否正在為恰當的公眾號呼叫介面 |
40002 |
不合法的憑證型別 |
40003 |
不合法的OpenID,請開發者確認OpenID(該使用者)是否已關注公眾號,或是否是其他公眾號的OpenID |
40004 |
不合法的媒體檔案型別 |
40005 |
不合法的檔案型別 |
40006 |
不合法的檔案大小 |
40007 |
不合法的媒體檔案id |
40008 |
不合法的訊息型別 |
40009 |
不合法的圖片檔案大小 |
40010 |
不合法的語音檔案大小 |
40011 |
不合法的視訊檔案大小 |
40012 |
不合法的縮圖檔案大小 |
40013 |
不合法的AppID,請開發者檢查AppID的正確性,避免異常字元,注意大小寫 |
40014 |
不合法的access_token,請開發者認真比對access_token的有效性(如是否過期),或檢視是否正在為恰當的公眾號呼叫介面 |
40015 |
不合法的選單型別 |
40016 |
不合法的按鈕個數 |
40017 |
不合法的按鈕個數 |
40018 |
不合法的按鈕名字長度 |
40019 |
不合法的按鈕KEY長度 |
40020 |
不合法的按鈕URL長度 |
40021 |
不合法的選單版本號 |
40022 |
不合法的子選單級數 |
40023 |
不合法的子選單按鈕個數 |
40024 |
不合法的子選單按鈕型別 |
40025 |
不合法的子選單按鈕名字長度 |
40026 |
不合法的子選單按鈕KEY長度 |
40027 |
不合法的子選單按鈕URL長度 |
40028 |
不合法的自定義選單使用使用者 |
40029 |
不合法的oauth_code |
40030 |
不合法的refresh_token |
40031 |
不合法的openid列表 |
40032 |
不合法的openid列表長度 |
40033 |
不合法的請求字元,不能包含\uxxxx格式的字元 |
40035 |
不合法的引數 |
40038 |
不合法的請求格式 |
40039 |
不合法的URL長度 |
40050 |
不合法的分組id |
40051 |
分組名字不合法 |
40060 |
刪除單篇圖文時,指定的 article_idx 不合法 |
40117 |
分組名字不合法 |
40118 |
media_id大小不合法 |
40119 |
button型別錯誤 |
40120 |
button型別錯誤 |
40121 |
不合法的media_id型別 |
40132 |
微訊號不合法 |
40137 |
不支援的圖片格式 |
40155 |
請勿新增其他公眾號的主頁連結 |
41001 |
缺少access_token引數 |
41002 |
缺少appid引數 |
41003 |
缺少refresh_token引數 |
41004 |
缺少secret引數 |
41005 |
缺少多媒體檔案資料 |
41006 |
缺少media_id引數 |
41007 |
缺少子選單資料 |
41008 |
缺少oauth code |
41009 |
缺少openid |
42001 |
access_token超時,請檢查access_token的有效期,請參考基礎支援-獲取access_token中,對access_token的詳細機制說明 |
42002 |
refresh_token超時 |
42003 |
oauth_code超時 |
42007 |
使用者修改微信密碼,accesstoken和refreshtoken失效,需要重新授權 |
43001 |
需要GET請求 |
43002 |
需要POST請求 |
43003 |
需要HTTPS請求 |
43004 |
需要接收者關注 |
43005 |
需要好友關係 |
43019 |
需要將接收者從黑名單中移除 |
44001 |
多媒體檔案為空 |
44002 |
POST的資料包為空 |
44003 |
圖文訊息內容為空 |
44004 |
文字訊息內容為空 |
45001 |
多媒體檔案大小超過限制 |
45002 |
訊息內容超過限制 |
45003 |
標題欄位超過限制 |
45004 |
描述欄位超過限制 |
45005 |
連結欄位超過限制 |
45006 |
圖片連結欄位超過限制 |
45007 |
語音播放時間超過限制 |
45008 |
圖文訊息超過限制 |
45009 |
介面呼叫超過限制 |
45010 |
建立選單個數超過限制 |
45011 |
API呼叫太頻繁,請稍候再試 |
45015 |
回覆時間超過限制 |
45016 |
系統分組,不允許修改 |
45017 |
分組名字過長 |
45018 |
分組數量超過上限 |
45047 |
客服介面下行條數超過上限 |
46001 |
不存在媒體資料 |
46002 |
不存在的選單版本 |
46003 |
不存在的選單資料 |
46004 |
不存在的使用者 |
47001 |
解析JSON/XML內容錯誤 |
48001 |
api功能未授權,請確認公眾號已獲得該介面,可以在公眾平臺官網-開發者中心頁中檢視介面許可權 |
48002 |
粉絲拒收訊息(粉絲在公眾號選項中,關閉了“接收訊息”) |
48004 |
api介面被封禁,請登入mp.weixin.qq.com檢視詳情 |
48005 |
api禁止刪除被自動回覆和自定義選單引用的素材 |
48006 |
api禁止清零呼叫次數,因為清零次數達到上限 |
50001 |
使用者未授權該api |
50002 |
使用者受限,可能是違規後接口被封禁 |
61451 |
引數錯誤(invalid parameter) |
61452 |
無效客服賬號(invalid kf_account) |
61453 |
客服帳號已存在(kf_account exsited) |
61454 |
客服帳號名長度超過限制(僅允許10個英文字元,不包括@及@後的公眾號的微訊號)(invalid kf_acount length) |
61455 |
客服帳號名包含非法字元(僅允許英文+數字)(illegal character in kf_account) |
61456 |
客服帳號個數超過限制(10個客服賬號)(kf_account count exceeded) |
61457 |
無效頭像檔案型別(invalid file type) |
61450 |
系統錯誤(system error) |
61500 |
日期格式錯誤 |
65301 |
不存在此menuid對應的個性化選單 |
65302 |
沒有相應的使用者 |
65303 |
沒有預設選單,不能建立個性化選單 |
65304 |
MatchRule資訊為空 |
65305 |
個性化選單數量受限 |
65306 |
不支援個性化選單的帳號 |
65307 |
個性化選單資訊為空 |
65308 |
包含沒有響應型別的button |
65309 |
個性化選單開關處於關閉狀態 |
65310 |
填寫了省份或城市資訊,國家資訊不能為空 |
65311 |
填寫了城市資訊,省份資訊不能為空 |
65312 |
不合法的國家資訊 |
65313 |
不合法的省份資訊 |
65314 |
不合法的城市資訊 |
65316 |
該公眾號的選單設定了過多的域名外跳(最多跳轉到3個域名的連結) |
65317 |
不合法的URL |
9001001 |
POST資料引數不合法 |
9001002 |
遠端服務不可用 |
9001003 |
Ticket不合法 |
9001004 |
獲取搖周邊使用者資訊失敗 |
9001005 |
獲取商戶資訊失敗 |
9001006 |
獲取OpenID失敗 |
9001007 |
上傳檔案缺失 |
9001008 |
上傳素材的檔案型別不合法 |
9001009 |
上傳素材的檔案尺寸不合法 |
9001010 |
上傳失敗 |
9001020 |
帳號不合法 |
9001021 |
已有裝置啟用率低於50%,不能新增裝置 |
9001022 |
裝置申請數不合法,必須為大於0的數字 |
9001023 |
已存在稽核中的裝置ID申請 |
9001024 |
一次查詢裝置ID數量不能超過50 |
9001025 |
裝置ID不合法 |
9001026 |
頁面ID不合法 |
9001027 |
頁面引數不合法 |
9001028 |
一次刪除頁面ID數量不能超過10 |
9001029 |
頁面已應用在裝置中,請先解除應用關係再刪除 |
9001030 |
一次查詢頁面ID數量不能超過50 |
9001031 |
時間區間不合法 |
9001032 |
儲存裝置與頁面的繫結關係引數錯誤 |
9001033 |
門店ID不合法 |
9001034 |
裝置備註資訊過長 |
9001035 |
裝置申請引數不合法 |
9001036 |
查詢起始值begin不合法 |