
يتم دمج الأقفال في تطبيق أو نظام PMS أو منصة مبنى عبر مجموعتين مختلفتين من الأدوات: واجهات API سحابية للعمليات عن بُعد وحزم SDK لـ Bluetooth للتحكم من الهاتف ضمن النطاق. الخلط بينهما هو أكثر أخطاء تخطيط التكامل شيوعًا.
عندما تحتاج تطبيقات جهة خارجية إلى تشغيل أقفال باب ذكية — سواء قناة تأجير تُصدر رموزًا، أو منصة مكتبية تجهّز بيانات الزوار، أو تطبيق فندق يسلّم مفاتيح متحركة — يتيح مورّد الأقفال واجهات قابلة للبرمجة عبر طبقتين. وتكون واجهة API السحابية عادةً خدمة بنمط REST عبر HTTPS: يتحقق التطبيق من الهوية باستخدام بيانات اعتماد بنمط OAuth، وينشئ رموز مرور أو مفاتيح إلكترونية، ويرسل أوامر فتح عن بُعد للأقفال المتصلة، ويستعلم عن حالة القفل، ويتلقى نداءات webhook عند فتح القفل أو انخفاض البطارية أوoccurrence عبث. أما حزمة SDK للهاتف المحمول فهي مكتبة مدمجة في تطبيق iOS أو Android الخاص بالمُكامل، وتتعامل مع اكتشاف Bluetooth، والاتصال الآمن، والفتح ضمن النطاق، ومنطق بيانات الاعتماد دون اتصال، من دون الحاجة إلى رحلة ذهاب وعودة إلى الخادم. وتستخدم عمليات التكامل الناجحة الطبقتين عن قصد، وتحمي بيانات الاعتماد، وتختبر حدود المعدلات وتسليم الأحداث قبل الإطلاق. يوضح هذا الدليل المفاهيم وأسئلة المورّدين المهمة. ويتم تأكيد توفر واجهات API وحزم SDK والنطاقات والتراخيص لكل منصة كتابيًا ضمن كل عرض سعر.
| واجهة API السحابية | تدير خدمات HTTPS الأقفال وبيانات الاعتماد والأحداث من خادم، ولا تصل إلى الأبواب عن بُعد إلا عندما تكون الأقفال متصلة عبر Wi-Fi أو عبر بوابة. |
| حزمة SDK للهاتف المحمول | تدير مكتبات iOS وAndroid المدمجة اتصال Bluetooth والفتح ضمن النطاق ومنطق العمل دون اتصال داخل تطبيق المُكامل. |
| المصادقة | تفصل بيانات اعتماد العميل بنمط OAuth والرموز ذات النطاق ونداءات webhook الموقعة بين المنصات الاحترافية وسكربتات الترحيل المفتوحة. |
| بيانات الاعتماد حسب واجهة API | تنشئ العمليات الشائعة رموز مرور مؤقتة ومفاتيح إلكترونية وبطاقات وروابط للزوار، مع نقاط نهاية للقائمة والتحديث والإلغاء. |
| تسليم الأحداث | تُشعِر نداءات webhook عند فتح القفل أو استخدام الرمز أو انخفاض البطارية أو أحداث الباب، ويجب توثيق سلوك إعادة المحاولة وضمانات الترتيب. |
| الاعتماد على الأجهزة | لا تُنفَّذ الأوامر عن بُعد إلا على الأقفال المتصلة عبر Wi-Fi أو البوابة، لذا يجب تخطيط تصميم API والطوبولوجيا المادية معًا. |
| سياستنا | نقدم توثيق الواجهات وبيئة اختبار أو أجهزة اختبار وجهة اتصال تقنية، بينما تأتي بيانات الاعتماد الإنتاجية والحدود من اتفاقية المنصة. |
تعمل الأتمتة من جانب الخادم — قنوات التأجير وPMS وإدارة الزوار — على واجهة API السحابية، بينما تضيف تطبيقات الهاتف ذات العلامة التجارية، التي توفر التحكم ضمن النطاق أو دون اتصال، حزمة SDK للهاتف المحمول. وينبغي للمنتجات التي تحتاج إلى كليهما أن تصمم نموذج بيانات الاعتماد قبل كتابة الشيفرة.
| هدف التكامل | مجموعة الأدوات الأساسية | الاعتماد الرئيسي |
|---|---|---|
| إصدار رموز تأجير مؤقتة | واجهة API السحابية من نظام الحجز الخلفي | يجب أن تدعم الأقفال نوع الرمز المستهدف ومسار المزامنة. |
| تطبيق مستأجر بالعلامة التجارية | حزمة SDK للهاتف المحمول مع واجهة API السحابية | يتولى فريق التطبيق إصدار SDK ومراجعة المتجر. |
| تسليم مفتتح فندق للهاتف المحمول | أحداث واجهة API السحابية من وسيط PMS | تغطية خدمة بيانات الاعتماد والبوابة عند الأبواب. |
| كشك إدارة الزوار | واجهة API السحابية لبيانات الاعتماد المؤقتة | التحقق مبكرًا من المناطق الزمنية ودلالات انتهاء الصلاحية. |
| خدمة استقبال مباشرة عن بُعد | فتح عبر واجهة API السحابية مع تأكيد عبر webhook | لا تنفذ الأقفال المتصلة إلا الأوامر عن بُعد فورًا. |
| محفظة مؤسسية دون اتصال | حزمة SDK للهاتف المحمول مع بيانات اعتماد محلية آمنة | قواعد تخزين المفاتيح وإلغاءها على الجهاز. |
تلتقي واجهات API بالواقع المادي عند نقطة الدخول: فالبوابات والأبواب المعدنية واستهلاك البطارية تحدد ما إذا كان استدعاء API السليم يصل إلى القفل في الوقت المناسب. يجب تجريب الأجهزة والبرمجيات معًا.
| نقطة الدخول | الباب المعتاد | منهج القفل |
|---|---|---|
| باب وحدة تأجير | قفل Bluetooth مع بوابة لكل منطقة | ينشئ نظام الحجز الخلفي رموزًا دون اتصال ومتصلة عبر واجهة API السحابية. |
| مدخل زجاجي للمكتب | قارئ أو وحدة تحكم متصلة | ترسل منصة الزوار بيانات اعتماد مؤقتة وتستقبل نداءات webhook الخاصة بالدخول. |
| غرفة نزيل فندق | قفل RFID مع خدمة مفتاح الهاتف المحمول | يستدعي وسيط PMS واجهة API للمفاتيح، فيما تدفع البوابة التحديثات المباشرة. |
| باب مساحة عمل مشتركة | قفل باب ذكي خلف واجهة زجاجية | يضم تطبيق العضوية حزمة SDK للفتح ضمن النطاق حتى مع ضعف Wi-Fi. |
| بوابة لوجستية | قفل خارجي متصل | تتطلب الأوامر عن بُعد اتصالًا مؤكدًا وجهات اتصال بديلة. |
| غرفة مرافق | قفل بالبطارية يُدار عن بُعد | تستخدم webhooks تدقيق الفتحات للفوترة ومراجعة إساءة الاستخدام في تطبيق المشغّل. |
تبدو واجهات API متشابهة في العروض التقديمية لكنها تختلف في بيئة الإنتاج. وقبل تخصيص وقت الهندسة، ينبغي للمُكاملين جمع العناصر التالية، التي نساعد على تنسيقها مع فريق المنصة.
| المكوّن | المنطق المعتاد | ملاحظات |
|---|---|---|
| مرجع API | نقاط النهاية والنطاقات والإصدارات وتوفر بيئة الاختبار. | تعتمد تقديرات الهندسة على توثيق كامل وحديث. |
| حزمة SDK | إصدارات أنظمة التشغيل المدعومة والتطبيقات النموذجية ووتيرة الإصدار. | يجب فهم موافقة المتجر ونماذج الصيانة. |
| النموذج الأمني | أنواع الرموز وتدوير الأسرار وتوقيع webhook وخيارات IP. | حماية نقاط نهاية الفتح أمر لا يقبل التنازل في بيئة الإنتاج. |
| الحدود والحصص | حدود المعدلات والترقيم والعمليات المجمعة وقواعد إعادة المحاولة. | قد يفشل إطلاق الأسطول لخلاف ذلك في ساعات تسجيل الوصول الذروة. |
| دليل الأحداث | أنواع الأحداث والحِمل وترتيبها وضمانات إعادة التسليم. | تعتمد ميزات التدقيق والإشعارات على الأحداث الموثوقة. |
واجهة API هي واجهة اتصال من خادم إلى خادم: يتصل خادمك الخلفي بمنصة الأقفال عبر HTTPS لإنشاء الرموز، وإرسال أوامر فتح القفل إلى الأقفال المتصلة، والاستعلام عن الحالة وتلقي أحداث webhook، وتعمل بغض النظر عن قرب الهاتف. أما حزمة SDK للجوال فهي مكتبة برمجيات مدمجة في تطبيق iOS أو Android الخاص بك، وتتواصل مباشرة مع الأقفال عبر Bluetooth، مما يتيح الفتح عندما يكون الجهاز قريبًا، والإعداد وتخزين بيانات الاعتماد دون اتصال عند تعذر الوصول إلى الخادم. تحتاج الأنظمة الخلفية للتأجير وتكاملات PMS أساسًا إلى واجهة API السحابية، بينما تحتاج تطبيقات المستأجرين ذات العلامة التجارية عادةً إلى SDK إضافة إلى بعض استدعاءات API المحددة. nonin. Trying to do everything through the API — for example unlocking a Bluetooth-only lock from across the world with no gateway — simply will not work, so the hardware topology and interface choice must be designed together. Available interfaces per platform are confirmed in writing per quotation.
نعم، هذا نمط تكامل معياري: عند تأكيد الحجز، يتصل خادمك الخلفي أو البرمجيات الوسيطة بواجهة API لمنصة الأقفال مع تحديد الغرفة أو الوحدة وتاريخ الوصول والمغادرة، ويتلقى رمز مرور أو مفتاح إلكتروني يُسلَّم إلى الضيف عبر قالب الرسائل أو البريد الإلكتروني الخاص بك. تُؤكد webhooks بعد ذلك استخدام الرمز وتُنبّه إلى أحداث مثل محاولات الوصول المبكر أو انخفاض مستوى البطارية. يجب تحديد المتطلبات المتعلقة بالتعامل مع المناطق الزمنية لنوافذ التواريخ، ونوع الرمز الذي يعمل دون اتصال على الأقفال المختارة، وتغطية البوابات للإلغاء الفوري، وإعادة المحاولات المتسقة عند إعادة إرسال الرسائل، وكيفية تحديث بيانات الاعتماد عند الإلغاء أو تغيير التواريخ. نوفر أقفال اختبار ون ندعم ورش عمل التكامل؛ وتُؤكد تفاصيل نقاط النهاية وحدود الاستخدام وتراخيص كل منصة كتابةً مع كل عرض سعر.
الفتح عن بُعد آمن عندما تكون المنصة مبنية مثل أي واجهة API مالية موثقة الهوية: باستخدام رموز OAuth بنطاقات محدودة، وتخزين الأسرار على الخادم، وصلاحيات منفصلة للموظفين، وتأكيد الأوامر عبر webhook، وسجلات تدقيق، واعتماد اختياري بعاملين للأبواب الحساسة. يصبح الأمر خطيرًا عندما يدمج المطورون أسرارًا دائمة في تطبيقات الهاتف، أو ي exposeون نقاط نهاية ترحيل مفتوحة، أو يسجلون روابط فتح القفل. الضوابط المادية مهمة أيضًا: لا تصل الأوامر عن بُعد إلا إلى الأقفال المتصلة، وكثيرًا ما تعطل الأبواب عالية الأمان الفتح عن بُعد تمامًا أو تتطلب موافقة مزدوجة. أثناء التقييم، اطلب الورقة البيضاء للأمان، وإجراء تدوير الرموز، ومخطط توقيع webhook بدلًا من مجرد قبول ادعاء توفر «واجهة REST». ننسق المراجعات هذه مع فريق المنصة، ويمكننا اقتراح بنيات تقصر الفتح عن بُعد على أدوار الاستقبال.
تُعد webhooks قناة الأحداث القياسية —,包括 سجلات الفتح، وإدخال الرموز، وانخفاض البطارية، وتنبيهات العبث، وتغيرات حساسات الأبواب — لكن دلالات التسليم تختلف حسب المنصة. توقّع المنصات الاحترافية البيانات وتعيد محاولة التسليمات الفاشلة وفق جدول متدرج وتوفر API لمطابقة الأحداث الفائتة أو الاستعلام عنها، وهذا مهم بسبب الانقطاعات المؤقتة للشبكات وكون التسليم المكرر أمرًا طبيعيًا؛ لذلك يجب على المستهلكين التعامل مع معرّفات الأحداث بطريقة متسقة. ضمانات الترتيب أضعف: قد يصل حدثان أُنشئا بفارق ثوانٍ بصورة معكوسة أحيانًا، لذا ينبغي أن تعتمد منطق التدقيق على وقت حدث القفل لا وقت الوصول. خلال مرحلة التجريب، محاكي مستقبِل غير متصل وتحقق من سلوك إعادة التشغيل. تُوثَّق فهرس الأحداث وسياسة إعادة المحاولة ونقاط_endpoint للمطابقة للمنصة المطلوبة كتابةً قبل بدء التطوير.
تمنح منصة الأقفال الوصول إلى API وفق شروط المطورين والتجارية الخاصة بها، عادةً إلى مالك الحساب: العلامة التجارية أو المشغّل الذي يملك مشروع السحابة، لا تلقائيًا لكل مشترٍ للقفل. يمكن للمصنع المساعدة في تفعيل الخدمة، وتقديم الوثائق، وتنسيق الإعداد التقني، لكنه لا يمنح حقوق تتجاوز اتفاقية المنصة. تفرّق بعض المنصات بين المستخدمين الذين يستخدمون التطبيق فقط، والحسابات التجارية ذات لوحات المعلومات، وشركاء المطورين المعتمدين الحائزين على وصول API كامل، كما تتطلب بعض نقاط النهاية المتقدمة مراجعة تكامل معتمدة. لذلك ينبغي للمشترين الذين يخططون لتكاملات معمقة تأكيد أهلية المطور والرسوم وشروط معالجة البيانات والمناطق المدعومة قبل اختيار الأجهزة، لأن القفل الممتاز بلا حق وصول إلى API لا يستطيع تشغيل المنتج المخطط. تُؤكد برامج المطورين الحالية والتراخيص لكل منصة مع كل طلب عرض سعر.
شارك معنا حالات استخدام التكامل وحزمة فريقك والجدول الزمني للإطلاق ضمن طلب عرض السعر. ننسق وثائق API وحزم SDK وأجهزة الاختبار واتفاقيات المنصات، ونقدم دعمًا لتجربة مشتركة تشمل التشغيل دون اتصال وإعادة المحاولة وأحداث الأساطيل الكبيرة.
طلب ورقة المواصفات وعرض السعرنظرة عامة على التقنياتآخر تحديث: 31 أكتوبر 2026 · تمت مراجعته من قلم التحرير في Smart Lock Factory