الحجوزات›إنشاء طلب عمل
إنشاء طلب عمل
يحجز عملًا ميدانيًا — أمر العمل الذي يدخل مسار الإرسال والجدولة. أرسل قيمة UUID للعميل مع `job_dates` المطلوبة (تاريخ + فترات صباحية/بعد الظهر/مسائية، ويُفضَّل عرضها من GET /job-requests/booking-windows)، مع `job_type_id` اختياري (كتالوج الخدمات) و`skill_ids` (مؤهلات الفنّيين المطلوبة) ووصف نصي حر. بعد ذلك يدفع التسعير وإسناد الفنّي/الطاقم والإنجاز أمرَ العمل عبر سير عمل النشاط التجاري.
المعاملات
X-Timezonestringheaderاختياري
المنطقة الزمنية للعميل بصيغة IANA
Idempotency-Keystringheaderاختياري
Unique key making retries safe: a repeat send with the same key returns the original booking instead of creating a duplicate
customer_idstringbodyمطلوب
قيمة UUID لعميل موجود لدى هذا النشاط التجاري لحجز العمل له. إلزامي.
descriptionstringbodyاختياري
وصف نصي حر للعمل المطلوب. اختياري؛ بحد أقصى 2000 حرف.
▾job_datesarray<object>bodyمطلوب
التاريخ (التواريخ) والفترة (الفترات) التي يريد العميل تنفيذ العمل فيها. عنصر واحد على الأقل، وحتى 12.
job_type_idstringbodyاختياري
قيمة UUID لنوع العمل لتصنيف هذا العمل. اختياري؛ القيمة null تترك العمل دون تصنيف.
priorityenumbodyاختياري
أولوية الجدولة. اختياري؛ تحصل الحجوزات المُغفَلة على إعداد default_priority الخاص بالنشاط التجاري (إعدادات الإسناد، الافتراضي p2). p0=طارئ (إدراج مُقاطِع)، p1=الأعلى (لا يُزاح إلا بـ p0)، p2=قياسي، p3=قابل للتأجيل (أول مرشّح للإزاحة).
skill_idsarray<string>bodyاختياري
قيم UUID للمهارات التي يرغب العميل فيها لهذا العمل. اختياري؛ حتى 20.
sla_deadlinestringbodyاختياري
الموعد النهائي لاتفاقية مستوى الخدمة (SLA) (تاريخ ووقت ساذج بالتوقيت المحلي للنشاط التجاري، مثل "2026-07-15T17:00:00"). اختياري؛ صالح فقط مع priority=p1 — يُفعّل ساعة التصعيد التلقائي (يتصاعد العمل إلى p0 عندما يتجاوز خطر الإخلال حاجز الأمان الخاص بالنشاط التجاري). يجب أن يكون في المستقبل.
POST/v1/job-requests
curl -X POST "https://api.crisphive.com/v1/job-requests" \ -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT" \ -H "Content-Type: application/json" \ -d '{ "customer_id": "9b2f6c3e-1a4d-4f0a-8f2e-7c5d1b3a9e01", "description": "Please call on arrival.", "job_dates": [ { "date": "2030-06-03", "periods": [ { "business_view": [], "period": "morning" } ] } ], "job_type_id": "9b2f6c3e-1a4d-4f0a-8f2e-7c5d1b3a9e01", "priority": "p1", "skill_ids": [ "9b2f6c3e-1a4d-4f0a-8f2e-7c5d1b3a9e01" ], "sla_deadline": "2030-06-14T17:00:00" }'
نص الطلب
{
"customer_id": ,
"description": ,
"job_dates": [
{
"date": ,
"periods": [
{
"business_view": [
],
"period":
}
]
}
],
"job_type_id": ,
"priority": ,
"skill_ids": [
],
"sla_deadline":
}
Bearer