عرض استلام نموذج

سنوضح في هذا المقال كيف يمكنك استرجاع استلام معين في مركز المساعدة.

طلب عرض الاستلام

يمكنك الحصول على استلام معين في مركز المساعدة من خلال إرسال طلب من نوع GET لنقطة الوصول {form-submissions/{id/ مع تمرير الرقم التعريفي للاستلام id كمتغير مسار ضمن عنوان URL للطلب، كما يلي:

عنوان URL

https://{your_subdomain}/api/agent/v1/form-submissions/{id}

معاملات المسار

معامل واحد هو الرقم التعريفي للاستلام id، نوعه عدد صحيح integer، وهو معامل إجباري.

معاملات الاستعلام

معامل واحد هو notes_sort، نوعه سلسلة نصية string، وهو معامل اختياري، يساعدك على ترتيب الملاحظات المكتوبة عن الاستلام المعروض حسب تاريخ إنشائها من الأقدم إلى الأحدث بإعطائه القيمة asc، أو من الأحدث إلى الأقدم بإعطائه القيمة desc.

مثال

يعرض المثال التالي الاستلام رقم 292 في مركز مساعدة له النطاق الفرعي support.example.com، ويقوم بترتيب ملاحظاته من أحدث ملاحظة إلى أقدم ملاحظة:

curl --header 'Authorization: Bearer your_token' 'https://support.example.com/api/agent/v1/form-submissions/292?notes_sort=desc'

تتضمن الاستجابة ما يلي:

• الرقم التعريفي للاستلام
• إعدادات لغة الاستلام locale
• اسم النموذج الذي ينتمي إليه مثل نموذج تواصل معنا
• معلومات عن مُنشِئ الطلب سواء كان وكيل أو شخص
• معلومات عن النموذج الذي ينتمي إليه الاستلام
• وكيل مركز المساعدة المُسند إليه الاستلام
• حالة الاستلام كالحالة مفتوحة أو مؤرشفة
• كافة حقول الاستلام مبينة ضمن المصفوفة fields التي توضح نوع كل حقل ومواصفاته وقيمته
• معلومات عن الشخص المعني بالنموذج
• سجل التغييرات التي طرأت على الاستلام
• الوسوم المضافة للاستلام
• وقت وتاريخ إنشاء الاستلام