企業應用每次調用接口時,可能獲得正確或錯誤的返回碼,企業可以根據返回碼信息調試接口,排查錯誤。
**注意:開發者的程序應該根據errcode來判斷出錯的情況,而不應該依賴errmsg來匹配,因為errmsg可能會調整。**
如果請求的參數不符合json規范,可能會導致企業微信解析到的參數不完整,此時接口在返回的errmsg里會有“Warning: wrong json format.”,開發者需要重新檢查請求參數的json合法性。
全局返回碼說明如下:
| 錯誤碼 | 錯誤說明 | 排查方法 |
| --- | --- | --- |
| \-1 | 系統繁忙 | 服務器暫不可用,建議稍候重試。建議重試次數不超過3次。 |
| 0 | 請求成功 | 接口調用成功 |
| 40001 | 不合法的secret參數 | secret在開發配置/配置服務頁面可查看 |
| 40004 | 不合法的媒體文件類型 | 不滿足系統文件要求。參考:[[上傳的媒體文件限制]](http://www.hmoore.net/dabashan/qiwei/2376081) |
| 40005 | 不合法的type參數 | 合法的type取值,參考:[上傳臨時素材](http://www.hmoore.net/dabashan/qiwei/2376081) |
| 40006 | 不合法的文件大小 | 系統文件要求,參考:[上傳的媒體文件限制](http://www.hmoore.net/dabashan/qiwei/2376081) |
| 40007 | 不合法的media\_id參數 | [看底部) |
| 40008 | 不合法的msgtype參數 | 合法的msgtype取值,參考:[消息類型](http://www.hmoore.net/dabashan/qiwei/2376075) |
| 40009 | 上傳圖片大小不是有效值 | 圖片大小的系統限制,參考[上傳的媒體文件限制](http://www.hmoore.net/dabashan/qiwei/2376081) |
| 40011 | 上傳視頻大小不是有效值 | 視頻大小的系統限制,參考[上傳的媒體文件限制](http://www.hmoore.net/dabashan/qiwei/2376081) |
| 40014 | 不合法的access\_token | [看底部](http://www.hmoore.net/book/dabashan/qiwei/edit#40007_37) |
| 40014 | 不合法的access\_token | [查看幫助](http://www.hmoore.net/book/dabashan/qiwei/edit#40007_37) |
| 90207 | 不合法的小程序appid | \- |
| 95000 | 不合法的open\_kfid | \- |
| 95001 | 發送客服消息次數限制 | 當用戶主動發送消息給微信客服時,企業最多可發送5條消息給用戶;若用戶繼續發送消息,企業可再次下發消息 |
| 95002 | 發送客服消息時間限制 | 當用戶在主動發送消息給微信客服時,可在48小時內調用該接口發送消息給用戶 |
| 95003 | 發送客服消息可接待客戶咨詢數限制 | 企業未驗證或未綁定視頻號 |
| 95004 | open\_kfid不存在 | 跨企業使用,或對已刪除的帳號操作 |
| 95005 | 客服帳號數超過限制 | 客服賬號數不能多于最大的數量限制,且至少有一個 |
| 95006 | 不合法的客服帳號名 | \- |
| 95007 | 不合法的msgtoken | msgtoken有時效性,可能為失效或者非法 |
| 95008 | 菜單消息的菜單項個數超過上限 | 目前最多允許10個菜單項 |
| 95009 | 不合法的菜單消息的菜單項類型 | \- |
| 95011 | 已在企業微信使用微信客服 | \- |
| 95017 | 企業內部自己調用API時,API開關處于關閉狀態 | \- |
## 排查方法
* ##### 錯誤碼:40007
不合法的媒體文件。確認:
1)媒體文件ID的獲取方式,是否存在。注:上傳臨時素材生成的medida\_id,有效期是3天。
2)媒體文件類型應符合接口要求(比如發送圖片消息,此時不能用音頻文件的media\_id)。
* ##### 錯誤碼:40014
access\_token參數錯誤。確認:
1)access\_token的獲取方式
2)access\_token是否已過期
可以重新獲取一次access\_token解決