ForHosting KIT · أدوات المطورين

فحص تعارض الأوقات والأنشطة المتداخلة في برنامج السفر

تفحص أداة تعارض أوقات برنامج السفر قائمة الأنشطة المخططة، وتحدد كل زوج يشغل الفترة الزمنية نفسها. أدخلوا اسم كل نشاط ووقت بدايته ونهايته بتنسيق HH:MM وفق نظام 24 ساعة. توضح النتيجة وجود التعارضات وعددها والأنشطة المتزامنة والفترة المشتركة بدقة. كما ترفض الأداة أي نشاط تقع نهايته قبل بدايته، حتى لا ينتج الجدول غير الصالح نتيجة مضللة.

● Betaمجاني · داخل متصفحك

شغّل الأداة مجانًا اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

أدخلوا برنامجاً واضحاً ليوم واحد

امنحوا كل نشاط اسماً واضحاً، وأدخلوا وقتي البداية والنهاية بتنسيق HH:MM وفق نظام 24 ساعة. تُعامل جميع العناصر على أنها تخص اليوم نفسه، ولذلك تناسب الأداة جولات مشاهدة المعالم والمؤتمرات والرحلات اليومية وخطط أيام التنقل. اختاروا أسماء يسهل تمييزها في النتيجة؛ فاسم «جولة المتحف المصحوبة بمرشد» أوضح من «جولة». لا يلزم ترتيب العناصر زمنياً. تقارن الأداة كل زوج وتحافظ على الفهرس الأصلي الذي يبدأ من 0، كي يستطيع أي نظام ربط التعارض بالسجل المرسل من دون تخمين. يجوز أن يتساوى وقتا البداية والنهاية؛ فهذا نشاط مدته صفر ولا ينشئ تداخلاً. أما النشاط الليلي من 23:00 إلى 01:00 فلا يندرج ضمن نموذج اليوم الواحد، لأن نهايته تبدو أسبق من بدايته. قسّموا الأنشطة الليلية حسب التاريخ أو استخدموا جدولة تتضمن تواريخ صريحة قبل إجراء الفحص.

اعرفوا بدقة ما الذي يُعد تعارضاً

يتعارض نشاطان فقط عندما يشتركان في مدة زمنية موجبة. إذا انتهت زيارة المتحف عند 11:00 وبدأ الغداء عند 11:00، فإن الفترتين تتلامسان عند الحد ولا تتداخلان. أما بدء الغداء عند 10:59 فينشئ تعارضاً مدته دقيقة واحدة. تعرض النتيجة لكل حالة اسمي النشاطين وفهرسيهما، وبداية الفترة المشتركة ونهايتها ومدتها بالدقائق. التقرير شامل عمداً: إذا اجتمعت ثلاثة أنشطة في الوقت نفسه، تظهر الأزواج الثلاثة كلها بدلاً من دمجها في كتلة مبهمة. وهكذا يستطيع المستخدم أو البرنامج معالجة كل علاقة بصورة مستقلة. تُعاد الأزواج بترتيب حتمي مستند إلى الإدخال، لا بحسب الشدة. إذا وقع نشاط بالكامل داخل نشاط آخر، ظل ذلك تعارضاً وكانت مدة النشاط الداخلي كلها هي فترة التداخل. كذلك تتعارض الفترات المتطابقة طوال مدتها الكاملة.

صححوا الفترات غير الصالحة واستفيدوا من النتيجة

تتحقق الأداة من كل وقت قبل المقارنة. يجب أن يتكون من رقمين للساعة، ونقطتين رأسيتين، ورقمين للدقائق، ضمن النطاق من 00:00 إلى 23:59. إذا سبقت أي نهاية بدايتها، يتوقف الطلب بخطأ إدخال. لا تفترض الأداة امتداد النشاط خلال الليل ولا تصحح القيمة تلقائياً، لأن ذلك قد يخفي خطأ في الحجز. مع البيانات الصالحة، استخدموا `has_conflicts` لاتخاذ قرار بسيط، و`conflict_count` لتلخيص الجدول، و`conflicts` لعرض التفاصيل بجوار السجلات الأصلية. يمكن لمخطط الرحلات أن يطلب الاختيار بين كل زوج، ويمكن لجدول بيانات تمييز الفهارس المذكورة. بعد تعديل البرنامج، أرسلوا القائمة الكاملة مجدداً؛ فالنتيجة التي لا تحتوي تعارضات تؤكد عدم بقاء أي تداخل ذي مدة موجبة. الحساب حتمي ولا يستخدم الشبكة أو الساعة الحالية. الاستخدام في المتصفح مجاني، ويطبق طلب API السعر الأساسي المنشور $0.002.

حالات الاستخدام

مراجعة يوم لمشاهدة المعالم

افحصوا تذاكر المتاحف والجولات والوجبات والتنقلات المحددة بوقت قبل اعتماد يوم مزدحم.

التحقق من برنامج مؤتمر

اكتشفوا الجلسات والاجتماعات والفعاليات التي تتطلب حضور الشخص نفسه في وقت واحد.

إضافة الفحص إلى مخطط

استخدموا الفهارس الثابتة وأزواج التعارض الكاملة لتمييز العناصر التي تحتاج إلى إعادة جدولة.

الأسئلة الشائعة

ما تنسيق الوقت المطلوب؟

استخدموا تنسيق HH:MM وفق نظام 24 ساعة من 00:00 إلى 23:59، مثل 09:30 أو 18:05.

هل تتعارض الأنشطة المتتالية مباشرة؟

لا. إذا انتهى نشاط في اللحظة التي يبدأ فيها الآخر، تتلامس الفترتان فقط ولا يُبلغ عن تعارض.

ماذا يحدث إذا سبقت النهاية البداية؟

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

هل يمكن الإبلاغ عن أكثر من تعارض؟

نعم. تُعاد كل الأزواج المتداخلة، بما فيها جميع التركيبات عندما تتزامن ثلاثة أنشطة أو أكثر.

هل يمكن فحص أنشطة في تواريخ مختلفة؟

ليس مباشرة. تقارن الأداة أوقات اليوم نفسه. اجمعوا الأنشطة حسب التاريخ وافحصوا كل يوم على حدة.

ما تكلفة طلب API؟

يستخدم طلب API السعر الأساسي المنشور $0.002. ويمكن إجراء الفحص الحتمي نفسه مجاناً في المتصفح.

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/travel2/itinerary-time-conflict-check

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/travel2/itinerary-time-conflict-check \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"activities":[{"name":"Museum visit","start":"09:00","end":"11:00"},{"name":"Walking tour","start":"10:30","end":"12:00"}]}'

const res = await fetch("https://api.kit.forhosting.com/travel2/itinerary-time-conflict-check", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "activities": [
      {
        "name": "Museum visit",
        "start": "09:00",
        "end": "11:00"
      },
      {
        "name": "Walking tour",
        "start": "10:30",
        "end": "12:00"
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/travel2/itinerary-time-conflict-check",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "activities": [
        {
            "name": "Museum visit",
            "start": "09:00",
            "end": "11:00"
        },
        {
            "name": "Walking tour",
            "start": "10:30",
            "end": "12:00"
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/travel2/itinerary-time-conflict-check", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"activities":[{"name":"Museum visit","start":"09:00","end":"11:00"},{"name":"Walking tour","start":"10:30","end":"12:00"}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"activities":[{"name":"Museum visit","start":"09:00","end":"11:00"},{"name":"Walking tour","start":"10:30","end":"12:00"}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/travel2/itinerary-time-conflict-check", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "activities": [
    {
      "name": "Museum visit",
      "start": "09:00",
      "end": "11:00"
    },
    {
      "name": "Walking tour",
      "start": "10:30",
      "end": "12:00"
    }
  ]
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "travel2.itinerary_time_conflict_check",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←