التحقق من ازدواج الحجز وتعارض المواعيد في غرفة الاجتماعات
اجتماع تخطيط من 09:00 إلى 10:30 ومقابلات من 10:00 إلى 11:00 يتعارضان بين 10:00 و10:30، بينما لا مشكلة في مراجعة تبدأ عند 11:00. وتُعرض كل الأزواج المتداخلة، لا أولها فقط. مجاناً في متصفحكم.
- مجاني
- يعمل في متصفحك
- دون تسجيل
- بياناتك لا تغادر جهازك
شغّل الأداة مجانًا
قد تبدو غرفة الاجتماعات المشتركة متاحة رغم أن حجزين يشغلان الفترة نفسها من اليوم من دون أن يظهر التعارض بوضوح. تفحص هذه الأداة قائمة حجوزات غرفة واحدة، وتتحقق من صحة كل نطاق زمني، وتعرض جميع أزواج الحجوزات المتداخلة. وهي تستخدم أوقاتاً واضحة لليوم نفسه بنظام 24 ساعة، وتعد لحظة انتهاء الحجز متاحة لبدء الحجز التالي، لذلك تقبل الحجوزات المتتابعة. النتيجة حتمية ومناسبة لفحص الجداول، والتحقق من بيانات الاستيراد، وإعداد تقرير موجز عن التعارضات قبل نشر التقويم.
جهزوا حجوزات غرفة واحدة
أرسلوا حجوزات غرفة واحدة فقط ضمن قائمة bookings. إن تخصيص كل طلب لغرفة واحدة ويوم واحد يجعل النتيجة مباشرة، لأن كل زوج يظهر في التقرير يمثل تنافساً حقيقياً على المكان المادي نفسه. استخدموا، متى أمكن، المعرفات الثابتة المعتمدة في نظام الجدولة لديكم، فالاستجابة تسمي التعارضات بهذه المعرفات بدلاً من الاعتماد على مواضع الصفوف.
ترفض الأداة القائمة الفارغة، والسجلات غير الصحيحة، والمعرفات المكررة، والأوقات المستحيلة، والمدخلات التي تتجاوز الحد المنشور. كما ترفض الحجز الذي يسبق وقت انتهائه وقت بدايته، ولا تفترض تلقائياً أنه يمتد بعد منتصف الليل. إذا كان المصدر يتضمن تواريخ أو مناطق زمنية أو حجوزات ليلية، فقسموا تلك البيانات أو وحدوا صيغتها قبل استخدام هذه الإمكانية.
يمنع هذا العقد الصريح تفسير الوقت المحلي بطرق مختلفة على الخادم أو المتصفح أو جدول البيانات، ويحافظ على تطابق النتائج عند تكرار التشغيل.
افهموا متى يقع التعارض
تُقيّم الحجوزات بوصفها فترات نصف مفتوحة؛ فوقت البداية جزء من الحجز، أما لحظة النهاية الدقيقة فهي متاحة للحجز التالي. لذلك لا يتعارض حجز من 09:00 إلى 10:00 مع حجز آخر من 10:00 إلى 11:00، بل يعدان حجزين متتابعين. أما إذا بدأ الحجز الثاني في 09:59، فسيظهر الزوج في التقرير.
تتضمن الاستجابة لكل تعارض معرفي الحجزين وبداية الفترة المشتركة ونهايتها. ويعد الإدخال ذو المدة الصفرية، حيث تتساوى start مع end، صالحاً، لكنه لا يشغل وقتاً ولا يمكن أن يتداخل مع حجز آخر. تعيد الخوارزمية جميع الأزواج المتعارضة، لا أول تعارض فقط ولا تعارضاً واحداً لكل حجز.
ويهم ذلك عندما تتزاحم عدة حجوزات حول الساعة نفسها؛ فثلاثة حجوزات يتداخل كل منها مع الآخر تنتج ثلاثة أزواج، مما يمنح المسؤول مجموعة العلاقات الكاملة التي ينبغي فحصها. تُرتب النتائج دائماً حسب الوقت، ويُستخدم ترتيب الإدخال الأصلي معياراً أخيراً عند التساوي، لكي تبقى المقارنات الآلية وسجلات التدقيق مستقرة.
استخدموا التقرير ضمن إجراءات الجدولة
توضح النتيجة العليا عدد الحجوزات التي جرى فحصها، وما إذا كانت هناك تعارضات، وعدد الأزواج المتعارضة التي عُثر عليها. عند وجود تعارضات، استخدموا حدود التداخل لشرح النافذة الزمنية المتنازع عليها بدقة، بدلاً من عرض تنبيه مبهم عن حجز مزدوج. لا تختار الإمكانية حجزاً فائزاً، ولا تنقل الاجتماعات، ولا تدمج الحجوزات المتجاورة؛ فهذه الإجراءات تعتمد على أولويات المؤسسة وينبغي أن تبقى ضمن سير عمل الجدولة لديكم.
شغلوا الفحص قبل نشر تقويم الغرفة، أو بعد استيراد الحجوزات من نظام آخر، أو كلما غيّر تعديل جماعي أوقاتاً عديدة دفعة واحدة.
حالات الاستخدام
التحقق من استيراد التقويم
افحصوا حجوزات الغرفة المستوردة قبل أن تستبدل جدول التقويم الأساسي أو تضيف إليه.
حماية التحديث الجماعي
اكتشفوا التعارضات التي تنشأ عندما يغير المسؤول أوقات اجتماعات عديدة في عملية واحدة.
إنشاء تقرير عن التعارضات
اعرضوا أزواج الحجوزات الدقيقة والفترات المشتركة التي يتعين على مسؤول المرافق تسويتها.
الأسئلة الشائعة
ما صيغة الوقت التي ينبغي استخدامها؟
استخدموا نظام 24 ساعة بصيغة HH:MM أو HH:MM:SS، مثل 09:30 أو 14:05:20.
هل تتعارض الحجوزات المتتابعة؟
لا. إذا انتهى حجز في اللحظة نفسها التي يبدأ فيها حجز آخر، فتُعد الغرفة متاحة للحجز الثاني.
ماذا يحدث إذا سبق وقت النهاية وقت البداية؟
وحّدوا صيغة الفترات الليلية أو قسموها قبل الفحص.
هل تتوقف الأداة بعد أول تداخل؟
لا. فهي تعرض كل زوج متعارض، بما في ذلك جميع الأزواج الممكنة ضمن مجموعة من الحجوزات المتزامنة.
هل يمكن فحص عدة غرف في طلب واحد؟
لا. يمثل كل طلب غرفة واحدة. اجمعوا الحجوزات بحسب الغرفة وافحصوا كل مجموعة على حدة.
أدوات ذات صلة
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/biz/meeting-room-double-booking-check \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"bookings":[{"booking_id":"planning","start":"09:00","end":"10:30"},{"booking_id":"interviews","start":"10:00","end":"11:00"},{"booking_id":"review","start":"11:00","end":"11:30"}]}'const res = await fetch("https://api.kit.forhosting.com/biz/meeting-room-double-booking-check", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"bookings": [
{
"booking_id": "planning",
"start": "09:00",
"end": "10:30"
},
{
"booking_id": "interviews",
"start": "10:00",
"end": "11:00"
},
{
"booking_id": "review",
"start": "11:00",
"end": "11:30"
}
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/biz/meeting-room-double-booking-check",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"bookings": [
{
"booking_id": "planning",
"start": "09:00",
"end": "10:30"
},
{
"booking_id": "interviews",
"start": "10:00",
"end": "11:00"
},
{
"booking_id": "review",
"start": "11:00",
"end": "11:30"
}
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/biz/meeting-room-double-booking-check", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"bookings":[{"booking_id":"planning","start":"09:00","end":"10:30"},{"booking_id":"interviews","start":"10:00","end":"11:00"},{"booking_id":"review","start":"11:00","end":"11:30"}]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"bookings":[{"booking_id":"planning","start":"09:00","end":"10:30"},{"booking_id":"interviews","start":"10:00","end":"11:00"},{"booking_id":"review","start":"11:00","end":"11:30"}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/biz/meeting-room-double-booking-check", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"bookings": [
{
"booking_id": "planning",
"start": "09:00",
"end": "10:30"
},
{
"booking_id": "interviews",
"start": "10:00",
"end": "11:00"
},
{
"booking_id": "review",
"start": "11:00",
"end": "11:30"
}
]
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "biz.meeting_room_double_booking_check",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الحدود
max_items | 1000 |
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
ملاحظات تقنية
جهزوا حجوزات غرفة واحدة
يحتاج كل صف إلى booking_id فريد، وإلى قيمتي start وend مكتوبتين بنظام 24 ساعة، إما بصيغة HH:MM وإما بصيغة HH:MM:SS.
استخدموا التقرير ضمن إجراءات الجدولة
يمكن لقائمة conflicting_pairs أن تغذي لوحة تحذير، أو رسالة لرفض الاستيراد، أو تقريراً يُرسل إلى المسؤولين عن الحجوزات. تكون قيمة has_conflicts في النتيجة السليمة false، وتكون قائمة الأزواج فارغة، وهذا ملائم لقاعدة بسيطة تقرر متابعة الإجراء أو إيقافه. تعمل الأداة بلا شبكة أو تخزين أو عشوائية أو تاريخ حالي، ويُسعّر طلب API باستخدام $0.002، مما يجعل الإدخال نفسه مناسباً للاختبارات القابلة للتكرار والتحقق في بيئة الإنتاج.
أسئلة تقنية
ما تكلفة طلب API؟
تبلغ تكلفة كل طلب API مقدار $0.002. تستخدم نسخة المتصفح منطق الفحص الحتمي نفسه.