أي جهاز يدعم HTTPS

يوفّر Chronix Hub نقطة وصول واحدة محايدة تجاه الشركات المصنّعة. يرسل جهازك (أو الصندوق الذي أمامه) معرّف الجهاز وبيانات الاعتماد التي قرأها للتو. يجيب Chronix Hub بقرار وسبب، ولا يفتح الجهاز إلا عند «نعم» صريحة.

المصادقة بمفتاح جهاز من نوع Bearer. كل مفتاح يخص جهازًا واحدًا ولا يستطيع إلا طرح أسئلة التحكم في الدخول، فلا يتيح مفتاح مسرَّب قراءة بيانات الأعضاء.

• منصات ووحدات تحكم في الدخول لديها خطوة قرار عبر HTTP أو webhook.
• وسيط أو خدمة مخصصة من المدمج بين القارئ والقفل.
• سكربت صغير على حاسوب أو Raspberry Pi بجوار القارئ، مع مرحّل نحو القفل.
• جهاز وجه يستطيع وسيطه إرسال معرّفه الخاص بالشخص.
• الأجهزة التي تتحدث بروتوكولها الخاص فقط لا تدعم HTTPS بذاتها. راجع صفحات ZKTeco وHikvision وSuprema وKisi.

1. 1

   أنشئ الباب والجدول

   تبويب «الأبواب»: سمِّ الباب واختر جدولًا وحدّد منع التمرير المزدوج. راجع النظرة العامة للتفاصيل.

2. 2

   أضف الجهاز

   تبويب «الأجهزة»، «إضافة جهاز». سمِّه، واختر الشركة المصنّعة «أخرى» (أي جهاز يستطيع استدعاء واجهة ويب) والباب. أضف عنوان IP العام للنادي إلى قائمة السماح.

3. 3

   انسخ المفتاح ومعرّف الجهاز

   يظهر المفتاح مرة واحدة. احفظه في مخزن أسرار الجهاز لا في مستند مشترك. ويدخل معرّف الجهاز (أو اسمه بالضبط) في كل طلب.

4. 4

   اجعل الجهاز يرسل POST عند كل لمسة

   أرسل الطلب أدناه إلى نقطة التحقق مع المفتاح كرمز Bearer. افتح الباب فقط عندما يكون الرد 200 مع granted: true.

5. 5

   أرسل نبضة اتصال

   اختياريًا: أرسل إلى نقطة نبضة الاتصال نحو مرة كل دقيقة ليعرض تبويب «الأجهزة» حالة «متصل» (سُمع منه خلال آخر دقيقتين).

6. 6

   جرّب ببطاقة حقيقية

   مرّر بطاقة عضو وراقب السجل المباشر. يجب أن ترى المحاولة وسببها خلال ثوانٍ.

curl -X POST https://api.chronixhub.com/api/v1/access/verify   -H "Authorization: Bearer $CHRONIX_DEVICE_KEY"   -H "Content-Type: application/json"   -d '{
    "deviceId": "Front turnstile",
    "credential": { "type": "card", "value": "0012345678" }
  }'

HTTP 200
{
  "granted": true,
  "reason": "active_membership",
  "memberId": "clx...",
  "memberName": "Sara Haddad",
  "expiresAt": "2026-12-31T23:59:59.000Z",
  "displayMessage": "Welcome, Sara"
}

HTTP 200
{
  "granted": false,
  "reason": "membership_frozen",
  "displayMessage": "Membership is frozen"
}

أنواع بيانات الاعتماد

أرسل بيانات اعتماد واحدة بالضبط في كل طلب.

curl -X POST https://api.chronixhub.com/api/v1/access/heartbeat   -H "Authorization: Bearer $CHRONIX_DEVICE_KEY"   -H "Content-Type: application/json"   -d '{ "deviceId": "Front turnstile", "firmwareVersion": "1.4.2" }'

HTTP 200
{ "ok": true, "serverTime": "2026-10-21T08:30:00.000Z" }

// Open the door ONLY on an explicit yes. Everything else is "no".
const res = await fetch("https://api.chronixhub.com/api/v1/access/verify", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.CHRONIX_DEVICE_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ deviceId, credential: { type, value } }),
});
const open = res.status === 200 && (await res.json()).granted === true;
if (open) unlockDoor();

قواعد يجب أن يلتزم بها تكاملك

• فقط HTTP 200 مع granted: true يفتح الباب. عامل كل حالة أخرى وكل انتهاء مهلة على أنه «لا».
• كل قرار، بما فيه الرفض، يعود بـ 200. أي حالة غير 200 تعني مشكلة في الطلب أو المفتاح: 400 أو 401 أو 403 أو 404 أو 429 أو 5xx.
• لا تضع المفتاح أبدًا في سلسلة استعلام أو عنوان URL. استخدم ترويسة Authorization.
• اعرض displayMessage على شاشة الجهاز إن وُجدت. هي قصيرة وآمنة للعرض.
• رمز PIN المرفوض لا يتضمن اسم عضو أبدًا، فلا تتوقعه.
• التزم بالحالة 429 بالانتظار قبل إعادة المحاولة. الحد الافتراضي 60 محاولة في الدقيقة لكل جهاز.
• الفتح عند الانقطاع إعداد لحالة عجز الجهاز عن الوصول إلى Chronix Hub إطلاقًا. خطأ الخادم ليس إذنًا بالفتح أبدًا.

• هل تستطيع وحدة التحكم أو الوسيط إرسال HTTPS POST برمز Bearer عند كل محاولة دخول والفتح بحسب الرد؟
• هل يمكنه إرسال رقم بطاقة ورمز مكتوب ومعرّف جهاز وجه ورمز QR ممسوح كقيمة لبيانات الاعتماد؟
• هل سيعامل كل خطأ وانتهاء مهلة وحالة غير 200 على أنه رفض؟
• هل يستطيع إرسال نبضة اتصال كل دقيقة تقريبًا؟
• أين سيُخزَّن مفتاح الجهاز، ومن يستطيع قراءته؟
• ما عنوان IP العام للنادي لنضيفه إلى قائمة السماح؟