公眾號(hào)每次調(diào)用接口時(shí)，可能獲得正確或錯(cuò)誤的返回碼，開發(fā)者可以根據(jù)返回碼信息調(diào)試接口，排查錯(cuò)誤。
全局返回碼說明如下：
| 返回碼 | 說明 |
|---|---|
| -1 | 系統(tǒng)繁忙，此時(shí)請(qǐng)開發(fā)者稍候再試 |
| 0 | 請(qǐng)求成功 |
| 40001 | 獲取 access_token 時(shí) AppSecret 錯(cuò)誤，或者 access_token 無效。請(qǐng)開發(fā)者認(rèn)真比對(duì) AppSecret 的正確性，或查看是否正在為恰當(dāng)?shù)墓娞?hào)調(diào)用接口 |
| 40002 | 不合法的憑證類型 |
| 40003 | 不合法的 OpenID ，請(qǐng)開發(fā)者確認(rèn) OpenID （該用戶）是否已關(guān)注公眾號(hào)，或是否是其他公眾號(hào)的 OpenID |
| 40004 | 不合法的媒體文件類型 |
| 40005 | 不合法的文件類型 |
| 40006 | 不合法的文件大小 |
| 40007 | 不合法的媒體文件 id |
| 40008 | 不合法的消息類型 |
| 40009 | 不合法的圖片文件大小 |
| 40010 | 不合法的語音文件大小 |
| 40011 | 不合法的視頻文件大小 |
| 40012 | 不合法的縮略圖文件大小 |
| 40013 | 不合法的 AppID ，請(qǐng)開發(fā)者檢查 AppID 的正確性，避免異常字符，注意大小寫 |
| 40014 | 不合法的 access_token ，請(qǐng)開發(fā)者認(rèn)真比對(duì) access_token 的有效性（如是否過期），或查看是否正在為恰當(dāng)?shù)墓娞?hào)調(diào)用接口 |
| 40015 | 不合法的菜單類型 |
| 40016 | 不合法的按鈕個(gè)數(shù) |
| 40017 | 不合法的按鈕類型 |
| 40018 | 不合法的按鈕名字長度 |
| 40019 | 不合法的按鈕 KEY 長度 |
| 40020 | 不合法的按鈕 URL 長度 |
| 40021 | 不合法的菜單版本號(hào) |
| 40022 | 不合法的子菜單級(jí)數(shù) |
| 40023 | 不合法的子菜單按鈕個(gè)數(shù) |
| 40024 | 不合法的子菜單按鈕類型 |
| 40025 | 不合法的子菜單按鈕名字長度 |
| 40026 | 不合法的子菜單按鈕 KEY 長度 |
| 40027 | 不合法的子菜單按鈕 URL 長度 |
| 40028 | 不合法的自定義菜單使用用戶 |
| 40029 | 無效的 oauth_code |
| 40030 | 不合法的 refresh_token |
| 40031 | 不合法的 openid 列表 |
| 40032 | 不合法的 openid 列表長度 |
| 40033 | 不合法的請(qǐng)求字符，不能包含 \uxxxx 格式的字符 |
| 40035 | 不合法的參數(shù) |
| 40038 | 不合法的請(qǐng)求格式 |
| 40039 | 不合法的 URL 長度 |
| 40048 | 無效的url |
| 40050 | 不合法的分組 id |
| 40051 | 分組名字不合法 |
| 40060 | 刪除單篇圖文時(shí)，指定的 article_idx 不合法 |
| 40117 | 分組名字不合法 |
| 40118 | media_id 大小不合法 |
| 40119 | button 類型錯(cuò)誤 |
| 40120 | 子 button 類型錯(cuò)誤 |
| 40121 | 不合法的 media_id 類型 |
| 40125 | 無效的appsecret |
| 40132 | 微信號(hào)不合法 |
| 40137 | 不支持的圖片格式 |
| 40155 | 請(qǐng)勿添加其他公眾號(hào)的主頁鏈接 |
| 40163 | oauth_code已使用 |
| 40227 | 標(biāo)題為空 |
| 41001 | 缺少 access_token 參數(shù) |
| 41002 | 缺少 appid 參數(shù) |
| 41003 | 缺少 refresh_token 參數(shù) |
| 41004 | 缺少 secret 參數(shù) |
| 41005 | 缺少多媒體文件數(shù)據(jù) |
| 41006 | 缺少 media_id 參數(shù) |
| 41007 | 缺少子菜單數(shù)據(jù) |
| 41008 | 缺少 oauth code |
| 41009 | 缺少 openid |
| 42001 | access_token 超時(shí)，請(qǐng)檢查 access_token 的有效期，請(qǐng)參考基礎(chǔ)支持 - 獲取 access_token 中，對(duì) access_token 的詳細(xì)機(jī)制說明 |
| 42002 | refresh_token 超時(shí) |
| 42003 | oauth_code 超時(shí) |
| 42007 | 用戶修改微信密碼， accesstoken 和 refreshtoken 失效，需要重新授權(quán) |
| 42010 | 相同 media_id 群發(fā)過快，請(qǐng)重試 |
| 43001 | 需要 GET 請(qǐng)求 |
| 43002 | 需要 POST 請(qǐng)求 |
| 43003 | 需要 HTTPS 請(qǐng)求 |
| 43004 | 需要接收者關(guān)注 |
| 43005 | 需要好友關(guān)系 |
| 43019 | 需要將接收者從黑名單中移除 |
| 43116 | 該模板因?yàn)E用被濫用過多，已被限制下發(fā) |
| 44001 | 多媒體文件為空 |
| 44002 | POST 的數(shù)據(jù)包為空 |
| 44003 | 圖文消息內(nèi)容為空 |
| 44004 | 文本消息內(nèi)容為空 |
| 44008 | 音頻內(nèi)容審核失敗 |
| 44009 | 圖文中的音頻內(nèi)容審核失敗 |
| 45001 | 多媒體文件大小超過限制 |
| 45002 | 消息內(nèi)容超過限制 |
| 45003 | 標(biāo)題字段超過限制 |
| 45004 | 描述字段超過限制 |
| 45005 | 鏈接字段超過限制 |
| 45006 | 圖片鏈接字段超過限制 |
| 45007 | 語音播放時(shí)間超過限制 |
| 45008 | 圖文消息超過限制 |
| 45009 | 接口調(diào)用超過限制 |
| 45010 | 創(chuàng)建菜單個(gè)數(shù)超過限制 |
| 45011 | API 調(diào)用太頻繁，請(qǐng)稍候再試 |
| 45015 | 回復(fù)時(shí)間超過限制 |
| 45016 | 系統(tǒng)分組，不允許修改 |
| 45017 | 分組名字過長 |
| 45018 | 分組數(shù)量超過上限 |
| 45047 | 客服接口下行條數(shù)超過上限 |
| 45064 | 創(chuàng)建菜單包含未關(guān)聯(lián)的小程序 |
| 45065 | 相同 clientmsgid 已存在群發(fā)記錄，返回?cái)?shù)據(jù)中帶有已存在的群發(fā)任務(wù)的 msgid |
| 45066 | 相同 clientmsgid 重試速度過快，請(qǐng)間隔1分鐘重試 |
| 45067 | clientmsgid 長度超過限制 |
| 45110 | 作者字?jǐn)?shù)超出限制 |
| 46001 | 不存在媒體數(shù)據(jù) |
| 46002 | 不存在的菜單版本 |
| 46003 | 不存在的菜單數(shù)據(jù) |
| 46004 | 不存在的用戶 |
| 47001 | 解析 JSON/XML 內(nèi)容錯(cuò)誤 |
| 47003 | 參數(shù)值不符合限制要求，詳情可參考參數(shù)值內(nèi)容限制說明 |
| 48001 | api 功能未授權(quán)，請(qǐng)確認(rèn)公眾號(hào)已獲得該接口，可以在公眾平臺(tái)官網(wǎng) - 開發(fā)者中心頁中查看接口權(quán)限 |
| 48002 | 粉絲拒收消息（粉絲在公眾號(hào)選項(xiàng)中，關(guān)閉了 “ 接收消息 ” ） |
| 48004 | api 接口被封禁，請(qǐng)登錄 mp.weixin.qq.com 查看詳情 |
| 48005 | api 禁止刪除被自動(dòng)回復(fù)和自定義菜單引用的素材 |
| 48006 | api 禁止清零調(diào)用次數(shù)，因?yàn)榍辶愦螖?shù)達(dá)到上限 |
| 48008 | 沒有該類型消息的發(fā)送權(quán)限 |
| 48021 | 自動(dòng)保存的草稿無法預(yù)覽/發(fā)送，請(qǐng)先手動(dòng)保存草稿 |
| 50001 | 用戶未授權(quán)該 api |
| 50002 | 用戶受限，可能是違規(guī)后接口被封禁 |
| 50005 | 用戶未關(guān)注公眾號(hào) |
| 53500 | 發(fā)布功能被封禁 |
| 53501 | 頻繁請(qǐng)求發(fā)布 |
| 53502 | Publish ID 無效 |
| 53600 | Article ID 無效 |
| 61451 | 參數(shù)錯(cuò)誤 (invalid parameter) |
| 61452 | 無效客服賬號(hào) (invalid kf_account) |
| 61453 | 客服賬號(hào)已存在 (kf_account exsited) |
| 61454 | 客服賬號(hào)名長度超過限制 ( 僅允許 10 個(gè)英文字符，不包括 @ 及 @ 后的公眾號(hào)的微信號(hào) )(invalid kf_acount length) |
| 61455 | 客服賬號(hào)名包含非法字符 ( 僅允許英文 + 數(shù)字 )(illegal character in kf_account) |
| 61456 | 客服賬號(hào)個(gè)數(shù)超過限制 (10 個(gè)客服賬號(hào) )(kf_account count exceeded) |
| 61457 | 無效頭像文件類型 (invalid file type) |
| 61450 | 系統(tǒng)錯(cuò)誤 (system error) |
| 61500 | 日期格式錯(cuò)誤 |
| 63001 | 部分參數(shù)為空 |
| 63002 | 無效的簽名 |
| 65301 | 不存在此 menuid 對(duì)應(yīng)的個(gè)性化菜單 |
| 65302 | 沒有相應(yīng)的用戶 |
| 65303 | 沒有默認(rèn)菜單，不能創(chuàng)建個(gè)性化菜單 |
| 65304 | MatchRule 信息為空 |
| 65305 | 個(gè)性化菜單數(shù)量受限 |
| 65306 | 不支持個(gè)性化菜單的賬號(hào) |
| 65307 | 個(gè)性化菜單信息為空 |
| 65308 | 包含沒有響應(yīng)類型的 button |
| 65309 | 個(gè)性化菜單開關(guān)處于關(guān)閉狀態(tài) |
| 65310 | 填寫了省份或城市信息，國家信息不能為空 |
| 65311 | 填寫了城市信息，省份信息不能為空 |
| 65312 | 不合法的國家信息 |
| 65313 | 不合法的省份信息 |
| 65314 | 不合法的城市信息 |
| 65316 | 該公眾號(hào)的菜單設(shè)置了過多的域名外跳（最多跳轉(zhuǎn)到 3 個(gè)域名的鏈接） |
| 65317 | 不合法的 URL |
| 87009 | 無效的簽名 |
| 9001001 | POST 數(shù)據(jù)參數(shù)不合法 |
| 9001002 | 遠(yuǎn)端服務(wù)不可用 |
| 9001003 | Ticket 不合法 |
| 9001004 | 獲取搖周邊用戶信息失敗 |
| 9001005 | 獲取商戶信息失敗 |
| 9001006 | 獲取 OpenID 失敗 |
| 9001007 | 上傳文件缺失 |
| 9001008 | 上傳素材的文件類型不合法 |
| 9001009 | 上傳素材的文件尺寸不合法 |
| 9001010 | 上傳失敗 |
| 9001020 | 賬號(hào)不合法 |
| 9001021 | 已有設(shè)備激活率低于 50% ，不能新增設(shè)備 |
| 9001022 | 設(shè)備申請(qǐng)數(shù)不合法，必須為大于 0 的數(shù)字 |
| 9001023 | 已存在審核中的設(shè)備 ID 申請(qǐng) |
| 9001024 | 一次查詢?cè)O(shè)備 ID 數(shù)量不能超過 50 |
| 9001025 | 設(shè)備 ID 不合法 |
| 9001026 | 頁面 ID 不合法 |
| 9001027 | 頁面參數(shù)不合法 |
| 9001028 | 一次刪除頁面 ID 數(shù)量不能超過 10 |
| 9001029 | 頁面已應(yīng)用在設(shè)備中，請(qǐng)先解除應(yīng)用關(guān)系再刪除 |
| 9001030 | 一次查詢頁面 ID 數(shù)量不能超過 50 |
| 9001031 | 時(shí)間區(qū)間不合法 |
| 9001032 | 保存設(shè)備與頁面的綁定關(guān)系參數(shù)錯(cuò)誤 |
| 9001033 | 門店 ID 不合法 |
| 9001034 | 設(shè)備備注信息過長 |
| 9001035 | 設(shè)備申請(qǐng)參數(shù)不合法 |
| 9001036 | 查詢起始值 begin 不合法 |
