ממשק ה-API של Oura מאפשר גישה קלה לנתונים שנוצרו על ידי Oura Ring. כדי להשתמש בממשק ה-API של Oura, תזדקקו לחשבון Oura ול'אסימון גישה אישי' או לאפליקציית API.
מהו ממשק ה-API של Oura?
כיצד להשתמש בממשק ה-API של Oura
כיצד ליצור 'אסימוני גישה אישיים'
כיצד להשתמש ב'אסימוני גישה אישיים'
מידע נוסף
מהו ממשק ה-API של Oura?
ניתן להשתמש בממשק ה-API של Oura כדי לאחזר את נתוני Oura שלכם או כדי לבנות אינטגרציה המאפשרת לכל אחד ואחת לשתף את נתוני Oura עם שירות צד שלישי.
ממשק Oura API V1 הופץ בשנת 2016 וממשק Oura API V2 הופץ בינואר 2022. התמיכה בגרסה 1 (V1) הופסקה בתחילת 2023.
כציד להשתמש בממשק ה-API של Oura
ניתן למצוא תיעוד מלא עבור Oura API V2 כאן.
משתמשי Gen3 ו-Oura Ring 4 ללא חברות Oura פעילה לא יוכלו עוד לגשת לנתונים שלהם דרך ממשק ה-API של Oura. יתר על כן, אפליקציות שותפים המשולבות עם ממשק ה-API של Oura לא יוכלו עוד לגשת לנתונים של משתמשי Gen3 ו-Oura Ring 4 שאין להם חברות פעילה ב-Oura. עם זאת, כל משתמשי 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 לא יחוו שינויים בזמינות הנתונים שלהם דרך ממשק ה-API של Oura.
כיצד ליצור 'אסימוני גישה אישיים'
Oura מציעה גם אסימוני גישה אישיים לאינטגרציה קלה יותר עם ממשק ה-API של Oura Cloud. אסימוני גישה אישיים אלה מקילים על האינטגרציה עבור מפתחים שרוצים לאחזר באופן תכנותי את נתוני Oura שלהם מממשק ה-Cloud API של Oura. איננו מספקים כרגע אסימוני גישה לקבוצות.
כדי להתחיל עם אסימוני גישה אישיים אלה, פעלו בהתאם לשלבים הבאים:
- מנווטים לדף 'אסימוני גישה אישיים'
- בפינה השמאלית העליונה של הדף לוחצים על 'יצירת אסימון גישה אישי חדש'
- מזינים הערה ייחודית עבור 'אסימון הגישה האישי' החדש שאתם עומדים ליצור
- לוחצים על 'יצירת אסימון גישה אישי' כדי לשלוח את הטופס וליצור את אסימון הגישה האישי החדש
כעת אמור להיות לכם אסימון גישה חדש רשום בדף 'אסימוני גישה אישיים'.
הקפידו להעתיק את האסימון החדש מכיוון שלא תוכלו לראות את האסימון לאחר שתצאו מהדף הזה. לחצו על 'העתק' כדי להעתיק את ערך האסימון ללוח שלכם.
כיצד להשתמש באסימוני גישה אישיים
לאחר שהשגתם את אסימון הגישה האישי שלכם, תוכלו להשתמש בו כדי לגשת לממשק ה-API של Oura. קיימות שתי דרכים לספק את 'אסימון הגישה האישי':
-
כותרת HTTP: יש לכלול את אסימון הגישה האישי בכותרת ההרשאה כך:
GET /v1/userinfo HTTP/1.1
Host: api.ouraring.com
Authorization: Bearer PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA -
URL parameter: הוסיפו את הפרמטר access_token לקריאה ל-API:
https://api.ouraring.com/v1/userinfo?access_token=PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA
באפשרותכם לבטל את אסימוני הגישה האישיים שלכם בכל עת.
