تنزيل unofficial_sense_api - تنزيل رمز المصدر unofficial_sense

unofficial_sense_api

باور بيلدر

1.0.0

تنزيل

API الإحساس غير الرسمي

الوصول إلى بيانات إحساسك.

تثبيت

أضف هذا السطر إلى Gemfile في التطبيق الخاص بك:

 gem 'unofficial_sense_api'

ثم تنفذ:

 $ bundle

أو تثبيته بنفسك على النحو التالي:

 $ gem install unofficial_sense_api

الاستخدام

الحصول على بيانات الوقت الفعلي (يبدأ WebSocket إلى wss://clientrt.sense.com/monitors/#{api.first_monitor_id}/realtimefeed )

 require 'sense_api'
require 'pp'

api = SenseApi . new ( "USERNAME" , "PASSWORD" )

count = 0
api . realtime do | json |
  pp json

  # Be sure to return :exit to terminate the connection and shut down EventMachine!
  count += 1
  count > 5 ? :exit : nil
end

استخدم fetch للسحب من نقاط نهاية الراحة التي تختارها. لم تتم إضافة أي منها إلى هذه الأحجار الكريمة حتى الآن.

 require 'sense_api'
api = SenseApi . new ( "USERNAME" , "PASSWORD" )

timeline = api . fetch ( "https://api.sense.com/apiservice/api/v1/users/ #{ api . user_id } /timeline?n_item=30" )

trends = api . fetch ( "https://api.sense.com/apiservice/api/v1/app/history/trends?monitor_id= #{ api . first_monitor_id } &scale=WEEK&start=2017-10-23T04:00:00.000Z" )

devices = api . fetch ( "https://api.sense.com/apiservice/api/v1/app/monitors/ #{ api . first_monitor_id } /devices?include_merged=true" )

first_device_id = devices . first [ "id" ]

first_device_details = api . fetch ( "https://api.sense.com/apiservice/api/v1/app/monitors/ #{ api . first_monitor_id } /devices/ #{ first_device_id } " )
first_device_hostory = api . fetch ( "https://api.sense.com/apiservice/api/v1/app/history/usage?monitor_id= #{ api . first_monitor_id } &granularity=MINUTE&start=2017-10-21T11:00:00.000Z&frames=5400&device_id= #{ first_device_id } " )

فيما يلي نقاط النهاية التي نعرفها حتى الآن:

"https://api.sense.com/apiservice/api/v1/users/#{api.user_id}/timeline?n_item=30"
"https://api.sense.com/apiservice/api/v1/app/history/trends?monitor_id=#{api.first_monitor_id}&scale=WEEK&start=2017-10-23T04:00:00.000Z"
"https://api.sense.com/apiservice/api/v1/app/history/usage?monitor_id=#{api.first_monitor_id}&granularity=SECOND&start=2017-10-25T03:54:00.000Z&frames=5400" MINUTE granularity SECOND

أجهزة قائمة:

"https://api.sense.com/apiservice/api/v1/app/monitors/#{api.first_monitor_id}/devices?include_merged=true"

يمكنك إضافة device_id إلى طلب السجل:

"https://api.sense.com/apiservice/api/v1/app/history/usage?monitor_id=#{api.first_monitor_id}&granularity=MINUTE&start=2017-10-21T11:00:00.000Z&frames=5400&device_id=SOME_DEVICE_ID"

واحصل على بيانات الأجهزة:

"https://api.sense.com/apiservice/api/v1/app/monitors/#{api.first_monitor_id}/devices/always_on"
"https://api.sense.com/apiservice/api/v1/app/monitors/#{api.first_monitor_id}/devices/unknown"
"https://api.sense.com/apiservice/api/v1/app/monitors/#{api.first_monitor_id}/devices/SOME_DEVICE_ID"

الوصول إلى API مع حليقة

إذا كنت ترغب في ذلك ، يمكنك تخطي Ruby تمامًا والتحدث مع API Sense مع حليقة:

curl -k --data "[email protected]" --data "password=URL_ENCODED_PASSWORD" -H "Sense-Client-Version: 1.17.1-20c25f9" -H "X-Sense-Protocol: 3" -H "User-Agent: okhttp/3.8.0" "https://api.sense.com/apiservice/api/v1/authenticate"

سيكون للاستجابة access_token ، بالإضافة إلى user_id ومجموعة monitors يمكنك استخدامها للوصول إلى واجهات برمجة التطبيقات للمعنى. على سبيل المثال:

curl -k -H "Authorization: bearer ACCESS_TOKEN" -H "Sense-Client-Version: 1.17.1-20c25f9" -H "X-Sense-Protocol: 3" -H "User-Agent: okhttp/3.8.0" "https://api.sense.com/apiservice/api/v1/app/history/usage?monitor_id=A_MONITOR_ID&granularity=SECOND&start=2017-10-24T05:36:00.000Z&frames=5400"

تطوير

يمكنك تشغيل bin/console للحصول على مطالبة تفاعلية تتيح لك التجربة.

لتثبيت هذه الأحجار الكريمة على جهازك المحلي ، قم بتشغيل bundle exec rake install . لإصدار إصدار جديد ، قم بتحديث رقم الإصدار في version.rb ، ثم قم بتشغيل bundle exec rake release ، والذي سيقوم بإنشاء علامة GIT للإصدار ، و Push Git Commits و Tags ، ودفع ملف .gem إلى rubygems.org.