文档开发者中心
我的

华为运动健康FAQ

1. 业务FAQ


Q1哪些合作伙伴可以接入运动健康平台?

A华为运动健康团队致力于为用户提供最好的用户体验和最佳的运动健康服务。

支持三类合作伙伴接入:

1. 智能硬件合作伙伴;

2. 健康服务合作伙伴(目前支持运动、体重管理和睡眠管理等领域);

3. 企业客户(通过华为穿戴设备进行员工健康管理)。

目前只针对精选服务合作伙伴进行数据开放,其他伙伴暂不开放。


Q2对于接入运动健康APP的三方服务,支持哪些接入方式?

A运动健康APP当前仅支持H5形式的服务接入,其它接入方式暂不支持。详细业务说明及开发指导,请参考:华为运动健康业务介绍。

Q3获得用户数据后,合作伙伴可以做哪些事情?

A华为高度重视用户的数据安全和隐私权利,并且也要求接入运动健康平台的合作伙伴遵守这一原则。因此,您在获取用户的任何数据之前,均要事先声明并获得用户授权;您需要对安全等级较高的用户数据进行加密存储。尤其需要注意的是,您对用户数据的处理,不得超过事先声明的范围,不得以任何形式向任何第三方转移用户数据。详细要求,请参考华为运动健康业务介绍中华为运动健康业务介绍-隐私策略的描述。


Q4运动健康业务合作联系方式?

A业务合作请联系:hihealth@huawei.com。


2. 端侧开放-JS接口FAQ


Q1调用signIn接口的时候,为什么会返回10错误?

A10错误表示鉴权失败。以下原因都可能返回该错误:

1. 使用了错误的app id;

2. 创建Web轻应用时没有配置正确的安全URL;

3. 传入的scope参数的权限类型与申请的范围不一致,或者尚未审批通过。

如果排除了以上原因仍无法解决问题,可联系华为接口人协助定位。

Q2调用signIn接口的时候,报9999错误是什么原因?

A网络环境错误是导致9999错误的主要原因。您可按以下步骤排除问题:                         

1. 华为运动健康平台当前仅开放中国大陆地区服务对接。请确定您所使用的服务器地址是否在国内,或者在开发调试过程中使用了VPN等。                         

2. 查看报文返回的message字段,依据其包含的错误码,对照华为帐号服务开发指南中的“表2-2 HMS 通用错误码及处理方式”查找具体原因。比如message为9的时候,表示需要升级更新华为移动服务。                         

如果依然无法解决问题,请用附件getJsSdkLog.bat抓取Android日志,并联系华为接口人协助定位。                         

getJsSdkLog.bat


Q3通过控制台安装华为移动服务时提示“INSTALL_FAILED_VERSION_DOWNGRADE”错误,该如何处理?

A提示INSTALL_FAILED_VERSION_DOWNGRADE表示手机上已经安装过华为移动服务,且其版本号高于待安装的版本。此时应先卸载手机上的华为移动服务,再安装目标版本APP即可。             


Q4在运动健康APP的服务入口打开服务页面时,显示空白,可能有哪些原因?

A这种情况通常是因为服务页面的URL没有添加到安全白名单中,或者APP尚未更新最新的白名单配置文件。您可以按以下步骤尝试排除问题:

1. 返回到运动健康APP首页并滑动页面,查看“服务”卡片是否显示了您的服务入口。                            

2. 如果没有的话,则下拉刷新首页,再次查看“服务”卡片中的内容是否更新。

3. 如果刷新后卡片中显示了您的服务入口,可再次尝试打开服务页面。

如果依然存在问题,可联系华为接口人协助定位。


3. 端侧开放-JAVA接口FAQ


Q1调用鉴权接口的时候,为什么不会一直弹出运动健康授权页?

A只有当APP申请的读写权限与上次调用时有新增变化时才会弹出授权页。


Q2调用数据读取/查询接口的时候,一直返回为空是什么原因?

A在排除查询数据确实为空的情况下,一种可能的原因是用户对APP请求读取的数据类型没有授权,因此无法获取。

如果依然无法解决问题,请联系华为接口人协助定位。

Q3锁屏状态下是否能够读取用户的运动健康数据?

A在锁屏状态下不允许APP读取用户在华为运动健康APP上的数据。

Q4获取实时心率和RRI数据不是一直连续的,是什么原因?

A获取实时数据通过华为穿戴设备提供能力,当前穿戴侧数据上报是有一定间隔的。


4. 云侧开放FAQ


Q1Web方式登录获取code,为什么报非法参数错误?

A

1、请参考Oauth错误码列表1101的报错提示。                    

2、参照华为运动健康开放平台鉴权说明,以授权码模式获取华为帐号授权时,需要向华为服务器传递完整的参数。您需要保证每一个参数都是准确无误的。尤其需要注意的是,很多开发者忽略或者传递了错误的 redirect_uri参数,这也会导致服务器返回“参数错误”的提示。因此,您需要仔细检查调用接口时传递的redirect_uri参数,与创建应用时填写的Redirect_URI是否完全一致。

t.png                    

注:您可以在开发者联盟网站找到已创建的应用并自行修改其Redirect_URI参数。您的修改将在保存设置后1个小时左右生效。

Q2 access_token、refresh_token、open_id最大长度要求,可以精简吗?

1、access_token、refresh_token长度由授权的scope列表多少决定的,一般情况下,长度不会超过512字节。不可精简。

2、open_id存储长度建议设置为不超过256字节。可通过修改联盟账号服务卡片,启用UnionId,使用更短的unionId(最大64位)来替代openId。                          注意:数据库里须同时保留openid,同时问题定位需要华为方提供协助时,须提供openid。

t.png


Q3通过Authorization Code获取Access Token,没有refresh_token字段?

A请仔细阅读获取Authorization Code的接口文档的请求参数, url中必须包含access_type参数。这样,在通过Authorization Code获取Access Token时,会一并返回refresh_token。

Q4 refresh_token什么场景下会过期,如何处理?

A1、refresh token并非永久有效,当前是6个月的有效时间,在接口里没有直接返回有效期,且未来可能会变更。

2、当以下场景时,会导致 refresh_token立即过期:

//修改密码 1 all

// 冻结账号 2 all

// 变更,删除账号 3 all

// 销户 4 all

// 删除设备(设备挤掉) 5 innerDevID, 用户删除单个设备

// 客户端apk登出 6 innerDevID, 用户从当前手机客户端apk(设备)登出

// 登出当前浏览器 7 innerDevID, 用户从当前浏览器登出

// 登出所有浏览器 8 all-browser

如果refresh_token过期,刷新access_token时,返回error为1203,sub_error为11205或者31204,此时三方须标记refresh_token过期,在下次用户登陆授权时,重走认证授权流程(详见OAuth2.0返回码表)。


Q5登录授权页面是在app上展示,始终不显示为移动版样式?

A请参考接口文档,带上mobile参数,如果依然不是移动版,请看下使用的UA(User Agent)是否是移动版本。


Q6调用接口为什么一直返回“session timeout”错误?

A1、access_token一般在一个小时以后过期,可通过基础能力接口getTokenInfo接口检查access_token过期时间。

2、参照运动健康云侧开放接口文档中“获取Authorization Code”的描述,您调用该接口后从响应报文中获得的“code”值,在使用时不应当进行2次编码,否则将导致您传递的参数与初始获取的code值不一致。使用无效的code获取token,服务器将返回“session timeout”错误。

例如:以下为原始数据,请注意识别:

BFEsZqBuaW/9G ==

经urlencode编码以后为:

BFEsZqBuaW/9G==

如果二次编码则为:

BFEsZqBuaW/9G==

3、access_token打印显示(使用curl 命令输出在控制台或postman、soapui等工具)时,特殊字符会存在“”转义符,需要去掉后再编码。如果不去掉,会报超时错误,正常代码逻辑处理不存在此问题。

例如:打印access_token 为

BFEsZqBuaW//9G ==

正确格式应为

BFEsZqBuaW//9G ==


Q7申请新的数据访问权限并且已经审批通过,调用接口时为什么依然提示'access forbidden'错误?

1、检查应用已包含权限,可通过get接口检查:

https://oauth-api.cloud.huawei.com/rest.php?nsp_svc=nsp.scope.app.get&nsp_fmt=json&appid={appid}&type=3,{appid}替换为开发者自己的appid。                 返回如下:

t.png

如果返回的scope列表里,没有你调用接口需要的权限,请在联盟上运动健康服务卡片或者华为接口人提出申请。

2、数据访问权限审批通过后,至少需要10分钟才能生效。您应当在权限生效后重新授权以获取新的Refresh Token和Access Token,否则您依然无法使用新的权限。

3、access_token是由用户授权生成的,包含用户的授权scope列表信息,可通过基础能力接口getTokenInfo接口检查此次access_token具有的又用户授权的scope列表。如果调用对应的接口没有对应权限,则必然会报错’’access forbidden’’。


Q8调用接口时传递的参数与示例完全一致,为什么还会提示“inner error”错误?

通常情况下,调用接口时参数格式不正确都会导致“inner error”错误。您可以阅读运动健康云侧开放接口文档中“1.4.1 公共参数”章节关于接口参数的统一说明。文档中带有urlencode字样的示例,均要求您在调用接口前先进行URL编码。如下所示:

                         

urlencode(

                   

   {

                         

       'startTime': 1460446147463,

                         

       'endTime': 1460964547463

                         

   }

                         

)

以上示例中,需要对包含大括号在内的蓝色字体部分进行URL编码,编码后的结果为:“{"startTime":1460446147463,"endTime":1460964547463}”。

注:

在使用工具调试接口过程中,对于包含换行符的多行报文,在编码前应先删除其中的换行符,将报文压缩成一行文本,然后再进行编码。


Q9调用云侧接口返回的json报文,为什么有些字段值为null?该如何处理?

A和业界大多数的实现一样,华为运动健康服务器对于空的对象(值为null),转换成json时依然会保留其字段,对应的value值则为null。如下所示:

{

                         

     'resultCode' : 0,

                         

     'summaries' : null,

                         

     'resultDesc' : null

                         

}

以上示例中,summaries和resultDesc这两个对象均为null,转换成json报文后,这两个字段的value就是null。因此,你应当按空值处理这两个对象。

             


Q10正式上线,接口查询请求多大比较合适?

A正式上线前,请三方主动与华为开发接口人沟通接口调用QPS的问题,如果比较大,可能会被流控。


Q11发现开放的部分数据上云存在延迟,即在运动健康app上可以看到展示的运动或者健康数据,但是通过授权的开放接口获取为空,请问是什么原因?

A1、用户网络权限问题:部分手机的管家、助手等可以限制单个应用的移动、WIFI网络权限,请确保网络没问题。

2、用户未授权:请检查用户协议是否已授权同意。点击我的-设置-隐私-华为运动健康通知,点击同意即可。

3、用户未开启数据上云开关:请打开运动健康app,点击我的-设置-隐私-打开数据管理下的所有开关。

4、用户数据未同步:由于android系统功耗考虑,系统无法保持常驻进程,因而无法实现实时上传数据到云端,华为运动健康app也正在努力优化数据上云延迟问题,但目前阶段,数据上云延迟问题不可避免,建议三方在页面显著位置,提示用户到运动健康app-我的-设置-手动同步数据,手动提交数据到云,同时,点击我的-设置-自动同步,打开自动同步开关。

5、如果检查以上仍有问题,可咨询华为接口人。


点赞
收藏
回复
2
分享
举报
浏览3705 编辑于2019-08-21 03:18未知归属地
全部评论
最多点赞
最新发布
最早发布
华为运动手表的“GPS”经常定位不准确,显示异常,该如何解决
2楼回复于2023-06-06 11:33 未知归属地

java对接华为云测开放接口;web登陆方式获取code,当code里带有空格的时候获取token失败,code里不带空格的时候可以正常获取,
请问这是什么原因呢?

1楼回复于2019-12-04 05:54 未知归属地
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要发帖子

了解社区公约,与您携手共创和谐专业的开发者社区。