أدلة إرشادية›أنشئ أول حجز لك
أنشئ أول حجز لك
يرشدك هذا الدليل من البداية إلى النهاية، من مفتاح API إلى طلب عمل محجوز، في خمس خطوات.
1
احصل على مفتاح API الخاص بك
أنشئ مفتاح اختبار ضمن الإعدادات → المطوّرون في لوحة التحكم. يبدأ بـ chsk_test_ ويُعرض مرة واحدة فقط عند الإنشاء.
2
ابحث عن العميل أو أنشئه
ابحث عن العميل، أو أنشئ عميلًا جديدًا إن لم يكن موجودًا بعد — يلزم full_name إضافة إلى الهاتف أو البريد الإلكتروني على الأقل.
curl -X POST "https://api.crisphive.com/v1/customers" \ -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT" \ -H "Content-Type: application/json" \ -d '{"full_name":"Lamar Bakery","email":"hello@lamarbakery.example"}'
3
اختر نوع العمل
اعرض قائمة الكتالوج الخاص بك للحصول على job_type_id الذي يصنّف العمل.
GET /v1/job-types
4
تحقّق من التوفّر
استرجع النوافذ القابلة للحجز لتواريخ العميل. ترويسة X-Timezone مطلوبة.
curl "https://api.crisphive.com/v1/job-requests/booking-windows?from=2026-07-02&to=2026-07-09" \ -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT" \ -H "X-Timezone: America/Toronto"
5
أنشئ طلب العمل
أرسل الحجز مع نافذة تاريخ مطلوبة واحدة أو أكثر، ثم تتبّعه عبر GET /v1/job-requests/{id} أو تغذية المزامنة.
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-…","job_type_id":"5d1b3a9e-…","job_dates":[{"date":"2026-07-02","periods":[{"period":"morning"}]}]}'
في هذه الصفحة