全局返回码
常见返回码
接口返回的数据按照下列方式组织。大致分为三种情况:
- 正常情况:返回码=0;
- 签名、权限等异常:返回码<0;
- 业务接口异常:返回码>0。
返回码示例
{
"code": 0,
"msg": 'success',
"data": {
"user_id": "u_58233df97455c_iC9L6Wpk",
"wx_union_id": "ozStBt1geNg5lh1bgb6rrH_vIYIM",
"wx_nickname": "Zooter",
"phone": "17817812015"
"created_at": "2016-07-01 08:00:00"
}
}
返回码详细说明
返回码 | 说明 |
---|---|
1001 | 系统繁忙 |
1002 | 业务接口返回值格式错误 |
2001 | 缺失 app_id 参数 |
2002 | 错误 app_id 参数 |
2003 | 缺失 secret_key 参数 |
2004 | secret_key 错误,或者 app_id 无效。请开发者认真比对 app_id,secret_key 的正确性 |
2005 | 缺失 grant_type 参数 |
2006 | 缺失 grant_type 参数 |
2007 | 缺失 凭证access_token |
2008 | access_token 过期 或者不存在 |
2009 | 缺失 userid 参数 |
2010 | user_id 无效 |
2017 | 没有请求本接口的权限,请申请对应接口权限集 |
2020 | 无效的client_id |
2051 | IP 没有添加白名单,需用用户配置服务器白名单ip |
2052 | 没有提供该API,用户请求的url错误,或者改url没有在系统中注册 |
2053 | API的调用次数达到上线 |
2054 | API的请求短时间突增 |
2055 | API请求方式错误 |
备注
- 更多异常状态代码请查看各接口的错误描述