De Oura-API maakt het gemakkelijk om toegang te krijgen tot gegevens die door de Oura Ring zijn gegenereerd. Om de Oura-API te gebruiken, heb je een Oura-account en een persoonlijk toegangstoken of een API-applicatie nodig.
Wat is de Oura-API?
Zo gebruik je de Oura-API
Persoonlijke toegangstokens genereren
Persoonlijke toegangstokens gebruiken
Meer informatie
Wat is de Oura-API?
De Oura-API kan worden gebruikt om je Oura-gegevens op te halen of een integratie te bouwen waarmee iedereen Oura-gegevens kan delen met een externe service.
De Oura-API V1 werd uitgebracht in 2016 en de Oura-API V2 in januari 2022. Ondersteuning voor V1 werd begin 2023 stopgezet.
Zo gebruik je de Oura-API
De volledige documentatie voor Oura-API V2 vind je hier.
Gen3 Oura Ring-gebruikers zonder actief Oura-lidmaatschap hebben geen toegang meer tot hun gegevens via de Oura-API. Bovendien hebben partnerapps die zijn geïntegreerd met de Oura-API geen toegang meer tot de gegevens van Oura Ring Generation 3-gebruikers die geen actief Oura-lidmaatschap hebben. Alle Oura-gebruikers kunnen echter nog steeds eenvoudig hun gegevensbestanden downloaden via Oura on the Web. Deze gegevensbestanden zullen minimaal voldoen aan de AVG-vereisten.
Oura-gebruikers moeten een update hebben uitgevoerd naar een recente versie van de mobiele Oura-app om nieuwe gegevenstypen te ondersteunen die beschikbaar zijn via de Oura-API V2.
Bestaande toegangstokens van de Oura-API V1 blijven geldig voor gebruik met de Oura-API V2 voor persoonlijke informatie, dagelijkse activiteit, dagelijkse uitgerustheid, dagelijkse slaap en bedtijdgegevens. Bestaande toegangstokens van de Oura-API V1 hebben geen toegang tot nieuwe gegevenstypen die beschikbaar zijn via de Oura-API V2, waaronder hartslagmeting overdag, hartslag tijdens work-out, work-outs, tags, sessies en andere gegevenstypen die in de toekomst worden toegevoegd. Voor toegang tot nieuwe gegevenstypen die door de Oura-API V2 worden aangeboden, kun je nieuwe persoonlijke toegangstokens maken of gebruikers vragen om toestemming te geven voor een nieuw gegevensbereik via het OAuth-autorisatieproces.
Gebruikers van de Oura Ring Generation 2 ondervinden geen wijzigingen in de beschikbaarheid van hun gegevens via de Oura-API.
Persoonlijke toegangstokens genereren
Oura biedt ook persoonlijke toegangstokens voor een eenvoudigere integratie met de Oura Cloud-API. Deze persoonlijke toegangstokens maken integratie gemakkelijk voor ontwikkelaars die hun Oura-gegevens programmatisch willen ophalen uit Oura's Cloud-API. We bieden momenteel geen groepstoegangstokens aan.
Volg de onderstaande stappen om aan de slag te gaan met deze persoonlijke toegangstokens:
- Ga naar de pagina Persoonlijke toegangstokens
- Klik in de rechterbovenhoek van de pagina op Een nieuw persoonlijk toegangstoken maken
- Voer een unieke opmerking in voor het nieuwe persoonlijke toegangstoken dat je gaat genereren
- Klik op 'Persoonlijk toegangstoken maken' om het formulier in te dienen en je nieuwe persoonlijke toegangstoken te maken
Je zou nu een nieuw toegangstoken moeten hebben dat wordt vermeld op de pagina Persoonlijke toegangstokens.
Zorg ervoor dat je dit nieuwe token kopieert, omdat je het token niet kunt bekijken zodra je naar een andere pagina gaat. Klik op Kopiëren om de tokenwaarde naar je klembord te kopiëren.
Persoonlijke toegangstokens gebruiken
Zodra je je persoonlijke toegangstoken hebt ontvangen, kun je deze gebruiken om toegang te krijgen tot de Oura-API. Er zijn twee manieren om het persoonlijke toegangstoken te verstrekken:
-
HTTP-header: Neem het persoonlijke toegangstoken als volgt op in de autorisatieheader:
GET /v1/userinfo HTTP/1.1
Host: api.ouraring.com
Autorisatie: Client PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA -
URL van parameter: Voeg de parameter access_token toe aan de API-aanroep:
https://api.ouraring.com/v1/userinfo?access_token=PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA
Je kunt je persoonlijke toegangstokens op elk moment intrekken.
