معاينة

طلبات المواعيد

يمكن للأنظمة الخارجية إرسال طلبات مواعيد أو خدمات إلى Ordinavo بشكل منظم وتتبع حالتها.

النهايات

POST/connect/v1/appointment-requests

GET/connect/v1/appointment-requests/{id}

GET/connect/v1/appointment-requests/{id}/status

POST/connect/v1/appointment-requests/{id}/cancel

نموذج البيانات: AppointmentRequest

الحقل	الوصف
`externalReference`	مرجع خارجي من النظام المصدر.
`serviceType`	نوع الطلب، مثل صيانة أو زيارة أو استلام أو فحص.
`priority`	أولوية الطلب.
`customer`	العميل أو المؤسسة أو الموقع الطالب.
`contact`	جهة الاتصال للاستفسارات أو تنسيق الموعد.
`location`	موقع التنفيذ.
`preferredTimeWindows`	النوافذ الزمنية المطلوبة.
`description`	وصف الطلب.
`metadata`	معلومات تقنية أو تشغيلية إضافية من النظام المصدر.

نموذج الحالة

Submitted Validated PendingReview Accepted Rejected Scheduled Assigned InProgress Completed Cancelled Failed

الإلغاء

POST /connect/v1/appointment-requests/{id}/cancel
Authorization: Bearer {access_token}
Content-Type: application/json
Idempotency-Key: 85f1ac0e-d641-47f4-99c2-0e04af2a1c19

{
  "reason": "Customer requested cancellation",
  "cancelledBy": "external_system"
}

{
  "id": "apr_01JZ7YQ1H7MP6Q5V8N9D4G3A2B",
  "status": "Cancelled",
  "cancelledAt": "2026-06-15T15:12:00Z"
}