Oura-API gör det enkelt att komma åt data som genereras av Oura-ringen. För att använda Oura-API behöver du ett Oura-konto och antingen ettpersonlig åtkomsttoken eller en API-applikation.
Vad är Oura-API?
Så här använder du Oura-API
Så här genererar du personliga åtkomsttoken
Så här använder du personliga åtkomsttoken
Mer information
Vad är Oura-API?
Oura-API kan användas för att hämta din Oura-data eller skapa en integration som gör att vem som helst kan dela sin Oura-data med en tredjepartstjänst.
Oura-API V1 släpptes 2016 och Oura-API V2 släpptes i januari 2022. Stödet för V1 upphörde i början av 2023.
Hur man använder Oura-API
Fullständig dokumentation för Oura-API V2 finns här.
Gen3 Oura Ring-användare utan aktivt Oura-medlemskap kommer inte längre att kunna komma åt sina data via Oura-API. Dessutom kommer partnerapplikationer som är integrerade med Oura-API inte längre att ha tillgång till data från Oura Ring Generation 3-användare som inte har något aktivt Oura-medlemskap. Men alla Oura-användare kommer fortfarande att enkelt kunna ladda ner sina datafiler via Oura på webben. Dessa datafiler kommer minst att uppfylla kraven för GDPR-förfrågningar.
Oura-användare måste ha uppdaterat till en ny version av Oura-mobilappen för att stödja nya typer av data som är tillgängliga via Oura-API V2.
Befintliga åtkomsttoken från Oura-API V1 kommer att fortsätta att vara giltiga för användning med Oura-API V2 för personlig information samt data om daglig aktivitet, dagsform, sömn och sänggående. Befintliga åtkomsttoken från Oura-API V1 kommer inte att ha tillgång till några nya typer av data tillgängliga via Oura-API V2, till exempel pulsmätning på dagtid, träningspuls, träningspass, taggar, sessioner och andra datatyper som kommer att släppas i framtiden. För åtkomst till nya typer av data som tillhandahålls av Oura-API V2 kan du antingen skapa nya personliga åtkomsttoken eller be användare att samtycka till ny dataomfattning via OAuth-auktoriseringsflödet.
Oura Ring Generation 2-användare kommer inte att uppleva några förändringar av tillgängligheten för data via Oura-API.
Hur man genererar personliga åtkomsttoken
Oura har också personliga åtkomsttoken för enklare integration med Oura Cloud-API. Dessa personliga åtkomsttoken gör integrationen enklare för utvecklare som programmatiskt vill hämta Oura-data från Ouras Cloud-API. Vi tillhandahåller för närvarande inga gruppåtkomsttoken.
Följ stegen nedan för att komma igång med dessa personliga åtkomsttoken:
- Navigera till sidan Personliga åtkomsttoken
- I det övre högra hörnet på sidan klickar du på "Skapa ett nytt personligt åtkomsttoken"
- Ange en unik anteckning för det nya personliga åtkomsttoken som du är på väg att generera
- Klicka på "Skapa personligt åtkomsttoken" för att skicka in formuläret och skapa ditt nya personliga åtkomsttoken
Du bör nu ha ett nytt åtkomsttoken i listan på sidan Personliga åtkomsttoken.
Kopiera detta nya token eftersom du inte kommer att kunna se token när du har navigerat från den här sidan. Klicka på "Kopiera" för att kopiera tokenvärdet till urklipp.
Hur man använder personliga åtkomsttoken
När du har skaffat ditt personliga åtkomsttoken kan det användas för att komma åt Oura-API. Det finns två sätt att tillhandahålla det personliga åtkomsttoknet:
-
HTTP-sidhuvud: Inkludera det personliga åtkomsttoknet i auktoriseringsrubriken så här:
GET /v1/userinfo HTTP/1.1
Host: api.ouraring.com
Tillstånd: Bärare PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA -
URL-parameter: Lägg till parametern access_token till API-anropet:
https://api.ouraring.com/v1/userinfo?access_token=PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA
Du kan när som helst återkalla dina personliga åtkomsttoken.