Die Oura-API erleichtert den Zugriff auf Daten, die vom Oura-Ring generiert wurden. Um die Oura-API zu nutzen, benötigst du ein Oura-Konto und entweder ein persönliches Zugriffstoken oder eine API-Anwendung.
Was ist die Oura-API?
So verwendest du die Oura-API
So generierst du persönliche Zugriffstoken
So verwendest du persönliche Zugriffstoken
Weitere Informationen
Was ist die Oura-API?
Mit der Oura-API kannst du Oura-Daten abrufen oder eine Integration erstellen, die es allen Nutzer*innen ermöglicht, ihre Oura-Daten mit einem Drittanbieterdienst zu teilen.
Die Oura-API V1 wurde 2016 veröffentlicht und die Oura-API V2 im Januar 2022. Die Unterstützung für V1 wurde Anfang 2023 eingestellt.
So verwendest du die Oura-API
Die vollständige Dokumentation für die Oura-API V2 findest du hier.
Oura-Nutzer*innen mit Gen3-Ring, aber ohne aktive Oura-Mitgliedschaft können nicht mehr über die Oura-API auf ihre Daten zugreifen. Außerdem haben Partneranwendungen, die in die Oura-API integriert sind, keinen Zugriff mehr auf die Daten von Oura-Nutzer*innen mit Gen3-Ring und ohne aktive Oura-Mitgliedschaft. Alle Oura-Nutzer*innen können ihre Datendateien jedoch weiterhin ganz einfach über Oura im Web herunterladen. Diese Datendateien entsprechen mindestens den DSGVO-Anforderungen.
Oura-Nutzer*innen müssen auf eine jüngere Version der mobilen Oura-App aktualisiert haben, um die neuen Datentypen der Oura-API v2 nutzen zu können.
Bestehende Zugriffstoken aus der Oura-API V1 bleiben für die Verwendung mit der Oura-API V2 für personenbezogene Daten sowie tägliche Aktivitäts-, Tagesform-, Schlaf- und Schlafenszeitdaten gültig. Bestehende Zugriffstoken aus der Oura-API V1 haben keinen Zugriff auf neue Datentypen, die über die Oura-API V2 verfügbar sind. Dies gilt unter anderem für Herzfrequenz tagsüber, Trainingsherzfrequenz, Trainingseinheiten, Tags, Sitzungen und zukünftige Datentypen. Für den Zugriff auf neue Datentypen, die von der Oura-API V2 bereitgestellt werden, kannst du entweder neue persönliche Zugriffstoken erstellen oder die Nutzer bitten, ihre Einwilligung zu neuen Datenbereichen über den OAuth-Autorisierungsvorgang zu geben.
Für die Nutzer*innen des Oura-Rings der 2. Generation ändert sich nichts an der Verfügbarkeit ihrer Daten über die Oura-API.
So generierst du persönliche Zugriffstoken
Oura bietet persönliche Zugriffstoken für die einfachere Integration in die Oura-Cloud-API. Diese persönlichen Zugriffstoken erleichtern die Integration für Entwickler, die ihre Oura-Daten programmgesteuert aus der Cloud-API von Oura abrufen möchten.Aktuell bieten wir keine Gruppenzugriffstoken an.
Gehe wie folgt vor, um die Arbeit mit diesen persönlichen Zugriffstokens zu beginnen:
- Gehe zur Seite Personal Access Tokens (Persönliche Zugriffstoken).
- Klicke in der oberen rechten Ecke auf „Create A New Personal Access Token“ (Neues persönliches Zugriffstoken erstellen).
- Gib eine identifizierende Anmerkung für das neue persönliche Zugangstoken ein, das du erstellen willst.
- Klicke auf „Create Personal Access Token“ (Persönliches Zugriffstoken erstellen), um das Formular zu übermitteln und dein neues persönliches Zugriffstoken zu erstellen.
Auf der Seite „Personal Access Tokens“ (Persönliche Zugriffstoken) sollte nun ein neues Zugriffstoken angezeigt werden.
Kopiere dieses neue Token unbedingt, da du es nicht mehr sehen kannst, sobald du die Seite verlassen hast. Klicke auf „Copy“ (Kopieren), um den Wert des Tokens in deine Zwischenablage zu kopieren.
So verwendest du persönliche Zugriffstoken
Sobald du dein persönliches Zugriffstoken erhalten hast, kannst du es für den Zugriff auf die Oura-API verwenden. Es gibt zwei Möglichkeiten, das persönliche Zugriffstoken bereitzustellen:
-
HTTP-Header: Füge das persönliche Zugriffstoken wie folgt in den Autorisierungsheader ein:
GET /v1/userinfo HTTP/1.1
Host: api.ouraring.com
Autorisierung: Bearer PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA -
URL-Parameter: Füge den Parameter access_token dem API-Aufruf hinzu:
https://api.ouraring.com/v1/userinfo?access_token=PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA
Du kannst deine persönlichen Zugriffstoken jederzeit widerrufen.
