Oura API 可以轻松访问 Oura Ring 生成的数据。使用 Oura API 需要一个 Oura 账户以及一个个人访问令牌或 API 应用。
Oura API 是什么？
如何使用 Oura API？
如何生成个人访问令牌？
如何使用个人访问令牌？
更多信息
Oura API 是什么？
Oura API 可用于获取你的 Oura 数据，或构建集成应用，允许用户将他们的 Oura 数据分享给第三方服务。
Oura API V1 于 2016 年发布，Oura API V2 于 2022 年 1 月发布。V1 版本的支持已于 2023 年初停止。
如何使用 Oura API？
未激活 Oura 会员的 Gen3 和 Oura Ring 4 用户，将无法再通过 Oura API 访问自己的数据。此外，与 Oura API 集成的合作伙伴应用也将无法访问未激活 Oura 会员的 Gen3 和 Oura Ring 4 用户的数据。不过，所有 Oura 用户仍然可通过会员中心轻松下载自己的数据文件。这些数据文件至少满足 GDPR 数据请求的要求。
Oura 用户必须将 Oura 移动端应用更新至最新版本，以支持 Oura API V2 的新增数据类型。
Oura API V1 的现有访问令牌在用于获取个人信息、每日活动、每日准备度、每日睡眠和就寝时间数据时，仍然可在 Oura API V2 中继续使用。但 Oura API V1 的现有访问令牌无法访问 Oura API V2 的新增数据类型，包括日间心率测量、锻炼心率、锻炼记录、标签、练习以及未来将发布的其他数据类型。要访问 Oura API V2 的新数据类型，你可以创建新的个人访问令牌或通过 OAuth 授权流程获取用户授权。
Oura Ring Generation 2 用户通过 Oura API 访问数据不受影响。
如何生成个人访问令牌
Oura 还提供个人访问令牌，以便更轻松地与 Oura Cloud API 集成。这些个人访问令牌让开发者能以编程方式从 Oura Cloud API 获取自己的 Oura 数据变得更加便捷。我们目前暂不提供群组访问令牌。
使用个人访问令牌，请按以下步骤操作：
- 进入个人访问令牌页面
- 在页面右上角点击“创建新的个人访问令牌”
- 为你即将生成的个人访问令牌输入一个唯一备注
- 点击“创建个人访问令牌”提交表单，生成你的新令牌
现在，你的个人访问令牌页面应当会列出新生成的令牌。
请务必复制新令牌，因为离开该页面后将无法再次查看令牌内容。点击“复制”可将令牌值复制到剪贴板。
如何使用个人访问令牌？
获得个人访问令牌后，即可用它来访问 Oura API。提供个人访问令牌的方法有两种：
-
HTTP 请求头：将个人访问令牌包含在授权请求头中，格式如下：
GET /v1/userinfo HTTP/1.1
Host: api.ouraring.com
Authorization:Bearer PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA -
URL 参数：在 API 调用中添加 access_token 参数：
https://api.ouraring.com/v1/userinfo?access_token=PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA
你可以随时撤销你的个人访问令牌。
