إيه اللي محتاجه
حساب في Kahraba فيه مشترك متصل، ومفتاح API تعمله من بوابة المطورين داخل التطبيق. المفتاح بيظهر مرة واحدة بس، فاحفظه في مكان آمن.
الأوامر الأساسية
GET /strips: قائمة مشتركاتك وحالة كل فتحة.
GET /strips/{mac}: تفاصيل مشترك واحد زي الحمل والجهد والإشارة.
POST /strips/{mac}/switch: تشغيل أو إيقاف فتحة أو الكل.
كل طلب بيتبعت ومعاه المفتاح في الهيدر x-api-key.
Home Assistant
أضف rest_command في إعدادات Home Assistant يبعت أمر التشغيل أو الإيقاف لـ Kahraba، وبعدها تستخدمه في الأتمتة والداشبورد بتاعتك. المثال الكامل موجود في صفحة المطورين.
Webhooks للتنبيهات
لو عايز نظامك يعرف لما المشترك يفصل أو يرجع أو أمر يفشل، ضيف رابط Webhook (لازم يكون https). كل رسالة بتتوقّع بـ HMAC عشان تتأكد إنها جاية من Kahraba.
الدليل الكامل
حمّل دليل الـ API بصيغة PDF من صفحة المطورين، وفيه أمثلة cURL وJavaScript وPython وPHP.