مكتبة Python

تنزّل حزمة Python hamapi البيانات التاريخية (datalogs) لأجهزتك. تقرأ الصفوف نيابة عنك وتعطي قائمة قيم واحدة لكل قراءة. يمكنك استخدامها بحرية (ترخيص MIT).

التثبيت

pip install hamapi

تحتاج إلى Python 3.6 أو أحدث. تثبّت الحزمة أيضًا requests وbrotli.

مثال

import time
import hamapi

ham = hamapi.hamapi(api_key='YOUR_API_KEY')

end = int(time.time())
start = end - 7 * 86400

data = ham.get_datalog_data('e11:123', start, end, averaging_step=120)
print(list(data.keys()))
print(data['timestamp'][:5])

api_key: تحصل عليه من صفحة الحساب في التطبيق. انظر REST API.
'e11:123': الرقم التسلسلي للجهاز. تحتاج إلى إذن القراءة على الجهاز.
start، end: وقت Unix بالثواني.
averaging_step: اختياري. تعطي الحزمة قيمة متوسطة واحدة لكل خطوة بهذا العدد من الثواني. مع 0 (الافتراضي) تحصل على كل الصفوف.

النتيجة

تعيد get_datalog_data قاموسًا (dictionary):

timestamp: وقت كل قيمة، بثواني Unix.
قائمة واحدة لكل قراءة ولكل مخرج في الجهاز، ومفتاحها رمز القراءة (مثلًا T). الرموز موجودة في قاموس القراءات.

لكل القوائم الطول نفسه. بدون averaging_step، في القوائم نقطة إضافية قبل كل تغيير مباشرة، لكي يعرض الرسم درجات.

دوال أخرى

ham.get_user_devices(): أجهزة حسابك، البيانات نفسها التي يعيدها get_user_devices.php.

ملاحظات

تحفظ الحزمة الأيام الماضية التي نزّلتها في الملف .cached.db، في المجلد الحالي. لا تنزّل هذه الأيام مرة أخرى. لتنزيلها مرة أخرى، احذف الملف.
تقرأ الحزمة السجل فقط. للبيانات المباشرة، استخدم WebSocket.
تحتوي الحزمة على تعريفات الأجهزة الخاصة بإصدارها. لأنواع الأجهزة الجديدة، حدّثها بالأمر pip install -U hamapi.
صفحة الحزمة: pypi.org/project/hamapi.

انظر أيضًا

الدردشة مع الدعم