يتم تنفيذ خادم الحجز باستخدام Node.js العادي بدون أي مكتبات أو إطارات عمل إضافية، وذلك لأغراض توضيحية. إذا كنت
تستخدِم أيّ إطارات عمل أخرى، يمكنك بسهولة تغيير عملية التنفيذ هذه إلى
Express.js أو MEAN.js أو أيّ إطار عمل آخر مستند إلى Node.js من اختيارك.
لا يستخدم التنفيذ أيضًا مكتبات بروتوكول الحِزم، بل يعتمد بدلاً من ذلك
على تسلسل JSON البسيط وطريقتَي JSON.parse() وJSON.stringify()
.
تتألف قاعدة الرموز البرمجية بالكامل من ملفي JavaScript فقط:
bookingserver.js: خادم HTTP ومنطق معالجة الطلبات، بما في ذلك المصادقة
apiv3methods.js - طرق تنفيذ واجهة الإصدار 3 من واجهة برمجة التطبيقات
بعد تنزيل الملفات، يمكنك بدء "خادم الحجز" من خلال تنفيذ
الأمر التالي:
nodebookingserver.js
يُسجِّل الهيكل جميع الطلبات الواردة والصادرة في وحدة التحكّم، حتى تتمكّن
من تتبُّع تنفيذه لأغراض التتبُّع.
إذا كنت بحاجة إلى بيئة تطوير متكاملة لإجراء تغييرات على الرموز البرمجية أو تصحيح الأخطاء، يمكنك استخدام IDE
Visual Studio Code أو أي IDE
آخر من اختيارك. يمكنك تصحيح أخطاء المشروع من خلال بدء bookingserver.js في بيئة
Node.js وضبط نقاط التوقف عند الحاجة.
اختبار خادم الحجز
نزِّل
أداة اختبار الحجز. لتثبيته، اتّبِع تعليمات التثبيت
المقدَّمة في صفحة README.
لإجراء الاختبارات، عليك إنشاء ملف نصي لتخزين بيانات الاعتماد.
أدخِل اسم المستخدم وكلمة المرور في سطر واحد، على سبيل المثال، في ملف
باسم cred.txt:
username:password
ستحتاج أيضًا إلى نسخة محلية من خلاصة معلومات التوفّر للتجّار الذين تختبرهم.
في نماذج الأوامر أدناه، تكون خلاصة مدى التوفّر هي avail.json.
يمكنك الآن اختبار خادم الحجز باستخدام الأوامر التالية:
أثناء تنفيذ "خادم الحجز" الخاص بك، قد تحتاج إلى إجراء
اختبارات إضافية عليه (مثل list_bookings_test وrescheduling_test وما إلى ذلك)
بهدف اجتياز جميع الاختبارات (-all_tests=true).
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis is a Node.js-based reference implementation of the API v3 Booking Server for Standard Integration, allowing developers to understand and build their own booking systems.\u003c/p\u003e\n"],["\u003cp\u003eThe server utilizes basic Node.js functionalities and JSON for serialization, offering flexibility for adaptation to various frameworks like Express.js or MEAN.js.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can clone the provided repository, run the server using a simple command, and leverage debugging tools like Visual Studio Code for development.\u003c/p\u003e\n"],["\u003cp\u003eA Booking test utility and sample commands are provided for validating the functionality of the implemented Booking Server using credentials and an Availability feed.\u003c/p\u003e\n"],["\u003cp\u003eFurther testing with additional commands is encouraged to ensure comprehensive coverage and successful integration with the Booking API.\u003c/p\u003e\n"]]],["This document details a Node.js-based reference implementation of an API v3 Booking Server. It uses standard Node.js and JSON serialization. Key actions include: cloning the project via `git`, starting the server with `node bookingserver.js`, and utilizing the Booking test utility for testing. To test, users must create a credentials file and use an Availability feed. Testing commands are provided for HealthCheck, CheckAvailability, CreateBooking, and UpdateBooking. It encourages comprehensive testing.\n"],null,[]]
