华为账号服务-服务器API示例
华为账号服务REST API的集成解决方案。
项目简介
华为账号服务-服务器API示例提供了凭证管理、用户信息、实名认证、订阅和处理用户信息变更等开放API的调用示例,帮助接入方快速集成华为账号服务。
环境依赖
- JDK: 1.8或更高版本
- Maven: 3.6或更高版本
工程目录
├── src/main/java/com/huawei/accountkit/
│ ├── credential/ # 凭证管理模块
│ │ ├── req/ # 请求参数类
│ │ ├── resp/ # 响应结果类
│ │ ├── GetAppCredentialService.java # 获取应用级凭证
│ │ ├── GetTokenInfoService.java # 解析凭证
│ │ ├── GetUserCredentialService.java # 获取用户级凭证
│ │ ├── RefreshUserCredentialService.java # 刷新用户级凭证
│ │ └── TokenRevokeService.java # 取消用户级凭证授权
│ ├── discontinuedapi/ # 停止维护的API模块
│ │ └── userinfo/ # 停止维护的用户信息API
│ │ ├── req/ # 请求参数类
│ │ ├── resp/ # 响应结果类
│ │ └── GetQuickLoginMobileByAccessTokenService.java # 一键登录获取华为账号绑定号码和UnionID/OpenID(已停止维护)
│ ├── extra/ # 扩展能力模块
│ │ ├── req/ # 请求参数类
│ │ ├── resp/ # 响应结果类
│ │ ├── GetGroupUnionIdService.java # 通过OpenID或UnionID获取GroupUnionID
│ │ ├── GetGroupUnionIdByCodeService.java # 通过Authorization Code获取GroupUnionID
│ │ ├── GetJwtPublicKeyService.java # 获取验证ID Token的JWT公钥信息
│ │ ├── GetOpenIdConnectConfigService.java # 获取OpenID Connect配置公开信息
│ │ ├── OpenIdToUnionIdService.java # 通过OpenID获取UnionID
│ │ └── VerifyIdTokenService.java # 验证ID Token有效性
│ ├── realname/ # 实名认证模块
│ │ ├── req/ # 请求参数类
│ │ ├── resp/ # 响应结果类
│ │ ├── GetDetailInfoService.java # 获取实名信息
│ │ ├── GetUserAgeRangeService.java # 获取用户实名年龄段
│ │ └── VerifyRealNameService.java # 实名信息校验
│ ├── subscribe/ # 订阅模块
│ │ └── HwUserInfoChangeHandler.java # 订阅和处理用户信息变更
│ ├── userinfo/ # 用户信息模块
│ │ ├── req/ # 请求参数类
│ │ ├── resp/ # 响应结果类
│ │ ├── GetAvatarAndNickNameByAccessTokenService.java # 获取华为账号用户信息-获取头像昵称
│ │ ├── GetMobileByAccessTokenService.java # 获取华为账号用户信息-获取手机号
│ │ ├── GetQuickLoginMobileByCodeService.java # 一键登录获取华为账号绑定号码和UnionID/OpenID
│ │ └── GetUserRiskLevelService.java # 获取用户风险等级
│ └── util/ # 工具类模块
│ └── CallUtils.java # HTTP调用工具类
├── src/test/java/com/huawei/accountkit/
│ ├── credential/ # 凭证管理模块测试
│ ├── userinfo/ # 用户信息模块测试
│ ├── extra/ # 扩展功能模块测试
│ ├── realname/ # 实名认证模块测试
│ └── discontinuedapi/ # 停用的API模块测试
使用说明
1. 开放接口调用凭证
主要功能
- GetAppCredentialService: 获取应用级凭证
- GetUserCredentialService: 获取用户级凭证
- RefreshUserCredentialService: 刷新用户级凭证
- GetTokenInfoService: 解析凭证
- TokenRevokeService: 取消用户级凭证授权
使用示例
// 获取用户级凭证
GetUserCredentialReq req = new GetUserCredentialReq();
// 通过客户端获取到的Authorization Code
req.setCode("your_authorization_code");
req.setClientId("your_client_id");
req.setClientSecret("your_client_secret");
// 固定传authorization_code
req.setGrantType("authorization_code");
// 调用API
GetUserCredentialResp resp = GetUserCredential.call(req);
String accessToken = resp.getAccessToken();
2. 获取用户信息
主要功能
- GetAvatarAndNickNameByAccessTokenService: 获取华为账号用户信息-获取头像昵称
- GetMobileByAccessTokenService: 获取华为账号用户信息-获取手机号
- GetQuickLoginMobileByCodeService: 一键登录获取华为账号绑定号码和UnionID/OpenID
- GetUserRiskLevelService: 获取用户风险等级
使用示例
// 获取华为账号用户信息-获取头像昵称
GetAvatarAndNickNameByAccessTokenReq req = new GetAvatarAndNickNameByAccessTokenReq();
req.setAccessToken("your_access_token");
// 1表示获取昵称
req.setGetNickName(1);
GetAvatarAndNickNameByAccessTokenResp resp = GetAvatarAndNickNameByAccessToken.call(req);
String headPictureURL = resp.getHeadPictureURL();
String displayName = resp.getDisplayName();
3. 实名信息认证
主要功能
- GetDetailInfoService: 获取实名信息
- GetUserAgeRangeService: 获取用户实名年龄段
- VerifyRealNameService: 实名信息校验
使用示例
// 获取用户实名年龄段
GetUserAgeRangeReq req = new GetUserAgeRangeReq();
req.setAccessToken("your_access_token");
req.setClientId("your_client_id");
GetUserAgeRangeResp resp = GetUserAgeRangeService.call(req);
4. 扩展能力
主要功能
- GetJwtPublicKeyService: 获取验证ID Token的JWT公钥信息
- VerifyIdTokenService: 验证ID Token有效性
- GetGroupUnionIdService: 通过OpenID或UnionID获取GroupUnionID
- GetGroupUnionIdByCodeService: 通过Authorization Code获取GroupUnionID
- OpenIdToUnionIdService: 通过OpenID获取UnionID
- GetOpenIdConnectConfigService: 获取OpenID Connect配置公开信息
使用示例
// 获取JWT公钥并验证ID Token
// 1. 获取JWT公钥
GetJwtPublicKeyResp publicKeyResp = GetJwtPublicKey.call();
// 2. 验证ID Token
String idToken = "your_id_token";
VerifyIdTokenResp verifyResp = VerifyIdToken.call(idToken);
5. 订阅和处理用户信息变更
使用示例
// 消息请求头中Authorization: Bearer <token>中的<token>
String token = "token";
// Client ID
String clientId = "your_client_id";
Optional<Jwt<?, ?>> jwtOptional = new HwUserInfoChangeHandler().validateSecurityEventToken(token, clientId);
if (!jwtOptional.isPresent()) {
// 验签失败
log.error("verify sign failed");
} else {
// 验签成功
log.info("verify sign success");
}
6. 工具类模块
提供HTTP调用和功能支持的核心工具类。
CallUtils
-
主要功能:
- HTTP客户端连接池管理
- 统一的异常处理机制
- JSON数据序列化/反序列化
-
关键特性:
- SSL/TLS支持:TLS 1.2协议
- 异常处理:针对不同API类型提供专门的错误处理
- JSON处理:基于FastJSON2的高效JSON处理
安全建议
- 敏感信息保护:Client Secret等敏感信息应加密存储,不要硬编码在代码中
- 令牌管理:妥善保管用户的Access Token和Refresh Token
相关文档
开源协议
华为账号服务-服务器API示例在Apache License 2.0下获得许可。