小米运动App内活动接入开放平台API指南 - zepp-health/rest-api GitHub Wiki

受众

小米运动app内需要访问用户数据（基本信息、步数、跑步、睡眠等）。如果不需要访问用户数据，请忽略此文档

接入入口

当小米运动app的用户点击到你的活动，看到授权页面并点击授权后，小米运动app会加载活动对应的入口地址，并且在后面附带一下的参数

参数名 描述 示例

access_token

访问开放平台API所需的OAuth 2.0的凭证

TAQABAAAAAJ95lT4WrRdWtG3hog/0QvXTnUpL3FFxKOLBgm4JjIKJbSozXYxtltsQzBz0Z9PXDiIKBUOLMfjWX5Je6tGEdXLeaYeCEVS0dVYMWG+p+Y7avcVe0SWY4jITNGfuq/tlNLK9cACSkIW/L6Mnb9YNp4CzQDo7dU9WrxK87aOJ7gAlE4leZKeCM3+xLY3zRs3BGZEwrsCmEMqPr14rrD2KHny6aD2UvGQfXdVGVExe8jRbMLw2L2KdRWrxEW7vZRzXdw==

refresh_token

当access_token过期时，用来获取新的access_token。目前的有效期是10年，但只能在用户的授权期内进行refresh

TAQEBAAAAAC7iIWnqI4uE6UgCUiBRg887o9H48QS3IhW5b8c4aJQtyn2ED73TeJKxhWhxVg5+e5lM8Gv5il9FWbQjG5rDKCVnLZ2VGxqrcj6pcAXrLmOQeTePl9dF507jX3awUjQ9RIi7PQhD5MzOlvNIciBhy6hrxU2u5pLt0uTWTJC36blvkwAmdZXQwIpxz2cJPfgTKWGGM1v4IT8uWkYRMWnvYUWOXoPvubp7MRRdVPyngtcbq3aAYCMMmbHilZs8x/jALQ==

expires_in

access_token的过期时长，单位秒。目前的过期时长为90天

7776000

token_type

token的种类，目前只会为Bearer

Bearer

例子

假设活动注册的入口地址为http://example.com?from=huami，http://example.com?from=huami&access_token=TAQABAAAAAJ95lT4WrRdWtG3hog/0QvXTnUpL3FFxKOLBgm4JjIKJbSozXYxtltsQzBz0Z9PXDiIKBUOLMfjWX5Je6tGEdXLeaYeCEVS0dVYMWG+p+Y7avcVe0SWY4jITNGfuq/tlNLK9cACSkIW/L6Mnb9YNp4CzQDo7dU9WrxK87aOJ7gAlE4leZKeCM3+xLY3zRs3BGZEwrsCmEMqPr14rrD2KHny6aD2UvGQfXdVGVExe8jRbMLw2L2KdRWrxEW7vZRzXdw==&refresh_tokenTAQEBAAAAAC7iIWnqI4uE6UgCUiBRg887o9H48QS3IhW5b8c4aJQtyn2ED73TeJKxhWhxVg5+e5lM8Gv5il9FWbQjG5rDKCVnLZ2VGxqrcj6pcAXrLmOQeTePl9dF507jX3awUjQ9RIi7PQhD5MzOlvNIciBhy6hrxU2u5pLt0uTWTJC36blvkwAmdZXQwIpxz2cJPfgTKWGGM1v4IT8uWkYRMWnvYUWOXoPvubp7MRRdVPyngtcbq3aAYCMMmbHilZs8x/jALQ==&expires_in=7776000&token_type=Bearer

访问开放平台API

在拿到用户的access_token之后，就可以访问开放平台的API了。具体参见API文档 https://huamitech.github.io/rest-api/api-doc.html

技术支持

华米第三方技术支持群 478417193，申请加入请填写公司-姓名。

Caution
 注意如果没有填写公司/姓名，加入请求不会被通过

FAQ

常见问题请参见 FAQ

⚠️ **GitHub.com Fallback** ⚠️