鸿蒙应用元服务开发-Account Kit 常见问题说明

发布于:2025-04-02 ⋅ 阅读:(21) ⋅ 点赞:(0)

一、OpenID和UnionID的格式说明

(一)长度

为减少开发者接入和迁移成本,Account Kit在2023年09月21日对OpenID、UnionID的长度做出了如下调整:

OpenID

应用创建时间晚于(含)2023年09月21日 23:00:00,OpenID固定28位。

应用创建时间早于2023年09月21日 23:00:00,OpenID长度不固定,最大256位。

UnionID

开发者账号注册时间晚于(含)2023年09月21日 23:00:00,UnionID固定29位。

开发者账号注册时间早于2023年09月21日 23:00:00,UnionID长度不固定,最大92位。

(二)唯一性标识

开发者账号下管理了多个应用时,针对同一个华为账号,不同的应用返回的OpenID值不同,但返回的UnionID相同。

如果开发者账号下管理了多个应用,并且这些应用需要共享同一个华为账号的用户信息,可以使用UnionID作为用户标识。

(三)数据类型

OpenID和UnionID均是字符串类型的数据。

(四)大小写敏感

OpenID和UnionID严格区分大小写。

(六)实际应用中的注意事项

在存储、查询或比较OpenID或UnionID时,请务必保持其原始的大小写格式。

二、Access Token和Refresh Token的有效时长是多久

Access Token的有效时长是1个小时,Refresh Token的有效时长是180天。

三、Access Token和Refresh Token长度限制要求

Access Token和Refresh Token的长度与其中编码的信息有关,目前来讲Access Token和Refresh Token的长度不会超过1024字符。

四、调用接口获取应用级Access Token时,是否有次数和频率限制

单个元服务在1小时内最多允许10000次调用获取应用级Access Token,超过该限制次数后失败。详细流控机制请参见华为OAuth应用级Access Token流控机制。

五、无法获取手机号或获取到的手机号为空如何解决

在手机号快速验证场景下,无法获取到明文手机号时,建议通过以下步骤排查解决:

请先检查手机号快速验证权限是否成功申请,详情可参考配置scope权限。

确认权限申请成功后,确认scope参数是否符合预期,手机号快速验证可参考快速验证客户端开发。

若调用接口还未获取到手机号,可将调试设备系统时间向后调整24小时。

六、未成年人模式开启后USB断连如何解决

开发者可以进入设置-系统-开发者选项,点击USB调试开关,会校验健康使用设备密码,校验成功后可解除开发者调试模式限制。

如开发者重新开启USB调试开关后,发现DevEco Studio工具上hilog日志未恢复到断连之前,请执行“hdc shell hilog -G 16M”来扩大hilog日志缓存区,若hilog日志仍无法完全展示,可取出hilog日志本地查看。更多命令请参见hilog。

本文主要引用参考HarmonyOS官方网站