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
Gen3 和 Oura Ring 4 使用者如果沒有有效的 Oura 會員資格，將無法再透過 Oura API 存取自己的資料。此外，與 Oura API 整合的合作夥伴 App，將無法再存取沒有有效 Oura 會員資格的 Gen3 和 Oura Ring 4 使用者的資料。然而，所有 Oura 使用者仍然可以輕鬆地透過會員中心下載自己的資料檔。至少，這些資料檔會符合 GDPR 對資料請求的最低要求。
Oura 使用者必須將 Oura 行動 App 更新到較新的版本，才能使用透過 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
你可以隨時撤銷個人存取權杖。
