YYour NameAccount Kit
56e26d57Add on Jul 2History

华为账号服务-服务器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处理

安全建议

  1. 敏感信息保护:Client Secret等敏感信息应加密存储,不要硬编码在代码中
  2. 令牌管理:妥善保管用户的Access Token和Refresh Token

相关文档

Account Kit(华为账号服务)REST API

开源协议

华为账号服务-服务器API示例在Apache License 2.0下获得许可。