تسهّل واجهة برمجة تطبيق Oura الوصول إلى البيانات التي يولّدها Oura Ring. لاستخدام واجهة برمجة تطبيق Oura، تحتاج إلى حساب Oura ورمز وصول شخصي أو تطبيق API.
ما هي واجهة برمجة تطبيق Oura؟
كيف أستخدم واجهة برمجة تطبيق Oura
كيفية إنشاء رموز الوصول الشخصية
كيفية استخدام رموز الوصول الشخصية
مزيد من المعلومات
ما هي واجهة برمجة تطبيق Oura؟
يمكن استخدام واجهة برمجة تطبيق Oura لاسترجاع بياناتك من Oura أو لإنشاء تكامل يتيح لأي شخص مشاركة بيانات Oura الخاصة به مع خدمة طرف ثالث.
تم إصدار Oura API V1 في عام 2016 وتم إصدار Oura API V2 في يناير 2022. تم إيقاف دعم الإصدار 1 في أوائل عام 2023.
كيف أستخدم واجهة برمجة تطبيق Oura
يمكنك العثور على الوثائق الكاملة للإصدار الثاني لواجهة برمجة تطبيق Oura هنا.
لن يتمكن مستخدمو Gen3 الجيل الثالث وOura Ring 4 الذين ليس لديهم عضوية Oura نشطة من الوصول إلى بياناتهم من خلال واجهة برمجة تطبيق Oura. علاوة على ذلك، لن تتمكن تطبيقات الشركاء المتكاملة مع واجهة برمجة تطبيق Oura من الوصول إلى بيانات مستخدمي Gen3 الجيل الثالث وOura Ring 4 الذين ليس لديهم عضوية Oura نشطة. ومع ذلك، سيظل بإمكان جميع مستخدمي Oura تنزيل ملفات بياناتهم بسهولة من خلال مركز العضوية. كحد أدنى، ستتوافق ملفات البيانات هذه مع متطلبات طلب اللائحة العامة لحماية البيانات.
يتعين على مستخدمي Oura التحديث إلى الإصدار الأخير من تطبيق Oura للجوال لدعم أنواع البيانات الجديدة المتوفرة من خلال الإصدار الثاني لواجهة برمجة تطبيق Oura .
ستظل رموز الوصول الشخصية الحالية من الإصدار الأول لواجهة برمجة تطبيق Oura صالحة للاستخدام مع الإصدار الثاني لواجهة برمجة تطبيق Oura للحصول على معلومات شخصية، والنشاط اليومي، والجاهزية اليومية، والنوم اليومي، وبيانات موعد النوم. لن تتمكن رموز الوصول الشخصية الحالية من الإصدار الأول لواجهة برمجة تطبيق Oura من الوصول إلى أي أنواع بيانات جديدة متاحة من خلال الإصدار الثاني لواجهة برمجة تطبيق Oura، بما في ذلك قياس معدل ضربات القلب أثناء النهار، ومعدل ضربات القلب أثناء التمرين، والتدريبات، والوسوم، والجلسات، وأنواع البيانات الأخرى التي سيتم إصدارها في المستقبل. للوصول إلى أنواع البيانات الجديدة التي توفرها الإصدار الثاني لواجهة برمجة تطبيق Oura، يمكنك إما إنشاء رموز وصول شخصية جديدة أو مطالبة المستخدمين بالموافقة على نطاقات بيانات جديدة عبر تدفق تفويض OAuth.
لن يواجه مستخدمو Oura Ring Generation 2 أي تغييرات في توفر بياناتهم من خلال واجهة برمجة تطبيق Oura .
كيفية إنشاء رموز الوصول الشخصية
توفر Oura أيضًا رموز وصول شخصية لتسهيل التكامل مع واجهة Oura السحابية. تُيسّر رموز الوصول الشخصية على المطوّرين إمكانية جلب بيانات Oura برمجيًا عبر واجهة Oura السحابية. لا تتوفر لدينا حاليًا أي رموز وصول شخصية للمجموعات.
للبدء في استخدام رموز الوصول الشخصية هذه، اتبع الخطوات التالية:
- انتقل إلى صفحة رموز الوصول الشخصية
- في الزاوية العلوية اليسرى من الصفحة، اضغط على "إنشاء رمز وصول شخصي جديد"
- أدخل ملحوظة فريدة لرمز الوصول الشخصي الجديد الذي أنت على وشك إنشائه
- اضغط على "إنشاء رمز وصول شخصي" لإرسال النموذج وإنشاء رمز وصولك الشخصي الجديد
يجب أن يكون لديك الآن رمز وصول جديد مدرجًا في صفحة رموز الوصول الشخصية.
تأكد من نسخ هذا الرمز الجديد لأنك لن تتمكن من عرض الرمز بمجرد الانتقال من هذه الصفحة. اضغط على "نسخ" لنسخ قيمة الرمز إلى حافظتك.
كيفية استخدام رموز الوصول الشخصية
بمجرد حصولك على رمز وصولك الشخصي، يمكنك استخدامه للوصول إلى واجهة برمجة تطبيق Oura. هناك طريقتان لتوفير رمز الوصول الشخصي:
-
عنوان HTTP: قم بتضمين رمز الوصول الشخصي في عنوان التفويض كالآتي:
GET /v1/userinfo HTTP/1.1
المضيف: api.ouraring.com
التفويض: Bearer PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA -
معامل عنوان الرابط (URL parameter): أضف معامل access_token إلى طلب واجهة برمج التطبيق:
https://api.ouraring.com/v1/userinfo?access_token=PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA
يمكنك إلغاء رموز وصولك الشخصية في أي وقت.
مزيد من المعلومات
الإصدار الثاني لواجهة برمجة تطبيق Oura
الإصدار الأول لواجهة برمجة تطبيق Oura
