钉钉API的错误码主要分为两类:一类是业务错误码,另一类是HTTP状态码。
对于业务错误码,其格式通常为“errcode = 数字”,其中,“errcode = 0”表示请求成功并正常返回,而“errcode = 88”则表示请求失败,此时需要关注返回结果里的sub_code和sub_msg。值得注意的是,应用程序应根据errcode来判断出错的情况,不要依赖errmsg来匹配,因为errmsg可能会调整。例如,如果确定access_token是正确的时候,请核对你的appid是否正确。
至于HTTP状态码,它们是由钉钉API直接返回的,常见的有:
以下是一些常见的钉钉API错误码:
正常返回:
errcode = 0
:表示请求成功。访问令牌相关错误:
errcode = 10002
:AccessToken无效。errcode = 10003
:RefreshToken无效。签名和时间戳相关错误:
errcode = 10004
:签名过期。频率限制错误:
errcode = 10005
:请求频率太高。接口未找到错误:
errcode = 10006
:API未找到。资源限制错误:
errcode = 10009
:超出消息/用户上限。权限相关错误:
errcode = 10010
:权限不足。errcode = 88
:请求失败,需要关注sub_code
和sub_msg
。此类情况下,一般是用户的access_token不合法或者没有调用该接口的权限。资源不存在错误:
errcode = 10011
:资源不存在。请求格式错误:
errcode = 10012
:请求格式错误。内部错误:
errcode = 10013
:内部错误。用户状态错误:
errcode = 10014
:群聊/部门/用户被禁用。用户授权相关错误:
errcode = 10015
:用户未授权应用。以上错误码列表可能并不全面,因为钉钉API可能会有其他特定的错误码。在遇到错误时,建议参考钉钉官方的开发文档以获取最准确和最新的错误码信息,并根据返回的errmsg
或sub_msg
来进一步了解错误的具体原因和解决方法。
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。