全局错误码

优质

小牛编辑

170浏览

2023-12-01

概述

轻应用/订阅号每次调用接口时，可能获得正确或错误的返回码，开发者可以根据返回码信息调试接口，排查错误。

错误码

通用错误码

参数	说明
-1	系统繁忙.
0	请求成功.
40001	获取access_token时AppSecret错误，或者access_token无效.
40002	不合法的凭证类型
40003	不合法的openid
40004	不合法的媒体文件类型
40005	不合法的文件类型
40006	不合法的文件大小
40007	不合法的媒体文件id
40008	不合法的消息类型
40009	不合法的图片文件大小
40013	不合法的appid
40014	不合法的access_token
40015	不合法的菜单类型
40016	不合法的按钮个数
40017	不合法的按钮类型
40018	不合法的按钮名字长度
40020	不合法的按钮URL长度
40022	不合法的子菜单级数
40029	不合法的qt_code
40030	不合法的refresh_token
40031	不合法的openid列表
40032	不合法的openid列表长度
40035	不合法的参数
40038	不合法的请求格式
40039	不合法的URL长度
40050	不合法的分组id
40051	分组名字不合法
40052	不存在的消息id
41001	缺少access_token参数
41002	缺少appid参数
41003	缺少refresh_token参数
41004	缺少appsecret参数
41005	缺少多媒体文件数据
41006	缺少media_id参数
41007	缺少子菜单数据
41008	缺少qt_code
41009	缺少openid
41010	富文本消息不满足要求
42001	access_token超时
42002	refresh_token超时
42003	qt_code超时
43001	需要GET请求
43002	需要POST请求
43003	需要HTTPS请求
43004	需要接收者关注
44001	多媒体文件为空
44002	POST的数据包为空
44003	图文消息内容为空
44004	文本消息内容为空
45001	多媒体文件大小超过限制
45002	消息内容超过限制
45003	标题字段超过限制
45004	描述字段超过限制
45005	链接字段超过限制
45006	图片链接字段超过限制
45008	图文消息超过限制
45009	接口调用超过限制
45010	创建菜单个数超过限制
46001	不存在媒体数据
46003	不存在的菜单数据
46004	不存在的用户
47001	解析JSON内容错误
48001	api功能未授权
50001	用户未授权该api
50002	未授权的域名

系统错误码

参数	说明
0	success
-1	system error
46100	data not exist
50401	unauthorized
45101	reject by request too frequently
45002	balance has been insufficient, please call 400-161-0019 for help

参数错误码

参数	说明
40100	invalid param
40100	accessToken is required
40100	app_id is required
40100	account_id is required
40100	secret is required
40100	org_id is required
40100	domain_id is required
40100	refresh_token is required
40100	page_size must be an integer less than or equals to 100
40100	page_size must be an integer greater than 1
40100	page_size is required
40100	request_page must be an integer
40100	request_page must be an integer greater than or equal to 1
40100	request_page is required
40100	users is required
40100	mobile phone is required
40100	name is required
40100	domain_number is required
40100	password is required
40100	parent_id is required
40100	sync_time must be a number greater than or equal to 0
40100	sync_time is required
40100	open_id is required

token错误码

参数	说明
40401	app_id or app_secret is unauthenticated
40402	invalid token
42403	expired token

组织机构错误码

参数	说明
50210	organization is not allowed
46306	org is not exists
48300	this org is not allowed to be delete
40301	org name must be difference with before
40300	different domain between parent and child
40299	org name exists in this parent node
45001	org grade is over 15

企业域错误码

参数	说明
46100	domain is not exists
60037	team members over limit with team auth
60038	team guest over limit with team auth
50210	organization is not allowed
46095	organization is not exists

用户错误码

参数	说明
0	success and the accounts [account1] [account2] will not change password
46001	user is not exists
46002	manager user cannot to be deleted
40009	password is invalid
41101	account_id or user_id is required
40090	invalid mobile
40091	invalid mail
40092	invalid name
45003	comment is too long
40093	invalid privacy
43010	mobile is already existed
43011	mail is already existed
40094	duplicate mobiles
40095	duplicate mails
46200	open_id is not exists
50211	domain not agree edit nickname
46320	open_id is not exists in this domain
46321	open_id is not follow the app
40019	user doesn't follow the app

常见问题-FAQ

报错信息提示“未授权的域名”，请检查安全域名是否配置正确。如果仍然报此错，可能是轻推APP缓存造成的，可以关闭和杀掉轻推进程，重新进入轻推。
```
{
 "errode":50002,
 "errmsg":"未授权的域名"
}
```
页面展示出现广告由于http协议不具备安全加密能力，请求链接容易出现网络劫持。如果出现这种情况，建议向当前使用的网络运营商反馈，或者升级到https加密传输协议。