目录

错误与异常机制

错误类型

其中,服务可以直接抛出异常,被平台所捕获,从而转化为NSP_STATUS。

错误建议处理机制

错误码

处理机制

0

检测HTTP STATUS,看是否正常。

1

检测NSP_STATUS,看是否正常。

2

根据调用服务的说明,看返回值中是否有错误。

HTTP STATUS描述

异常码

描述

200

成功。

400

参数错误。

401

需要鉴权。

403

无权限访问。

404

找不到服务。

405

不支持的http请求method。

500

开放网关发生异常。

502

请求连接异常,常见于网络状况不稳定。

503

系统流控。

504

请求连接超时,常见于网络状况不稳定。

590

服务内部错误。

NSP STATUS描述

异常码

描述

0

成功。

1

一个未知的错误发生。

2

服务临时不可用。

3

未知的方法。

4

应用已达到设定的请求上限。

5

请求来自未经授权的IP地址。

6

当前用户session key过期了。

7

调用次数超过了限制。

8

调用太频繁。

100

无效未知参数。

101

无效的API_KEY。

102

无效的SESSION_KEY。

103

必须是POST提交。

104

无效的签名。

105

缺少系统参数:如nsp_svc、nsp_ts、nsp_key等。

106

app或者session没有调用当前服务的权限。

107

client和secret需要重新获取(如算法升级等)。

108

路由失败,无法识别服务投递地址。

109

nsp_ts偏差过大。

110

接口内部异常。

403

无权限。

500

调用接口出错。

501

服务分发异常。

503

触发系统流控。

1302

接口流控。

31204

access_token已失效。正常access_token有效期为3600秒,但是由于用户的行为(如更改密码、取消应用的授权等行为),导致华为服务器提前失效已颁发的access_token。

70001201

参数不合法

70001401

系统内部错误。

70001402

系统鉴权错误。

70020002

内部网络错误。

接口错误码描述

主错误码

子错误码

描述

1101

12304

client_id和client_secret不匹配。

1101

20002

client_id格式校验不通过,应该为全数字。

1101

20003

client_id在系统中不存在。

1101

20012

response_type格式校验不通过,应该为“code”。

1101

20022

redirect_uri格式校验不通过。

1101

20023

redirect_uri与华为开发者联盟注册的回调地址不一致,且不在OAuth服务配置的允许清单中。

1101

20024

授权码code换取令牌AT(Access Token)时,code解析出来的redirect_uri和入参不一致。

1101

20031

state格式校验不通过。

1101

20041

scope格式校验不通过。

1101

20042

scope在系统不存在。

1101

20051

access_type格式校验不通过。

1101

20071

display格式校验不通过,显示指定授权页面展示风格规则:PC端为“page”、移动端为“touch”。

1101

20073

code_challenge_method值非法,当前只支持选项“S256”、“plain”。

1101

20074

code_challenge值非法,base64无法解码。

1101

20085

  • 授权码扩展模式(PKCE)流程,code_verifier参数不满足格式规则。
  • 授权码模式(Authorization Code)流程,client_secret传参为空。

1101

20152

授权码code换取令牌AT时,code格式校验不通过。

1101

20154

授权码code、设备码code或RT(Refresh Token)中解析出来的client_id和入参client_id不一致。

1101

20155

授权码code换取令牌AT时,code已过期,默认有效期为5分钟。

1101

20156

授权码code换取令牌AT时,code已经被请求过一次,每个code能且仅能请求一次。

1101

20158

  • 授权码扩展模式(PKCE)流程,code_verifier格式校验不通过。
  • 授权码模式(Authorization Code)流程,code已失效。

1101

20159

code_verifier与code_challenge不匹配。

1101

20171

在grant_type参数传“device_code”、“refresh_token”或“client_credentials”时,client_secret传参为空。

1101

20172

换取令牌AT时,client_secret格式校验不通过。

1101

20182

换取令牌AT时,grant_type值非法,仅支持选项“authorization_code”、“client_credentials”、“refresh_token”、“device_code”。

1101

20192

RT(Refresh Token)换取令牌AT时,refresh_token格式校验不通过。

1101

20404

user code已经到期。

1101

20406

设备码code换取AT时,code已经被请求过一次,每个code能且仅能请求一次。

1101

20407

设备码code换取AT时,code换取AT轮询次数超过限制,需要重新获取。

1101

20408

设备码code换取AT时,code解析出来的scope校验不通过。

1101

20411

设备码code换取AT时,二维码超时了仍未被扫描。

1101

20412

设备码code换取AT时,用户扫描二维码后,超时了仍未授权。

1101

20414

设备码code换取AT时,用户扫描二维码后,用户在授权页点击取消。

1101

22023

redirect_uri如果以非hms开头,回调地址不是在开发者联盟上注册的地址。

1102

20001

client_id为空。

1102

20011

response_type为空。

1102

20021

redirect_uri为空。

1102

20151

换取令牌AT时,授权码code或设备码code为空。

1102

20181

换取令牌AT时,grant_type为空。

1102

20191

RT换取令牌AT时,refresh_token为空。

1103

20153

code非法。

1203

500

系统内部错误。

1203

1203

系统未知异常。

1203

11205

RT换取令牌AT时,refresh_token过期。

1203

12303

授权码code换取令牌AT时,client_id在系统不存在。

1203

12304

授权码code换取令牌AT时,client_secret不对。

1203

31202

RT换取令牌AT时,refresh_token满足了正则表达式校验,但解析失败。

1203

31204

RT换取令牌AT时,refresh_token在禁用清单中(用户修改密码或者退出操作,会使之前的RT被加入禁用清单)。

1203

56000

系统内部调用出现异常。

1203

56100

系统内部调用连接超时。

1203

56200

系统内部调用socket超时。

1203

57000

系统内部调用触发熔断。

1203

100305

id_token的header解析成功后的内容不是JSON格式。

1203

100306

id_token的payload解析成功后的内容不是JSON格式。

1203

150021

id_token的header解析失败。

1203

150022

id_token的payload解析失败。

1203

150023

id_token的signature解析失败。

1400

14004

无法通过其kid找到对应的JWT公钥相关信息。

1500

15003

无效的id_token。

1500

15004

id_token验证失败。

1500

15005

id_token的issuer验证失败。

1500

15006

id_token已过期。

1500

15007

id_token为空。

1500

15008

id_token格式不正确。

1600

16002

设备码code换取AT时,无法解开。

1600

16003

设备码code换取AT时,device code超期。

1600

16001

设备码device code无法编码(本报错属于服务器报错,服务器正常配置情形下不会出现)。

1203

-

其他错误,包括内部组件之间网络不通等错误。