تعديل ملاحظة خاصة باستلام

محتويات الصفحة

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

    تعديل ملاحظة خاصة باستلام

    لتعديل الملاحظة يمكنك استخدام نقطة الاتصال التالية
    {form-submissions/{form_submission_id}/notes/{note_id/ حيث:

    • عنوان URL لنقطة الاتصال:
      https://{your_subdomain}/api/agent/v1/form-submissions/{form_submission_id}/notes/{note_id}.
    • نوع الطلب: PUT.
    • معاملات المسار Path Parameters:
      • form_submission_id الرقم التعريفي للاستلام، وهو مُعَامِل إجباري، نوعه عدد صحيح integer.
      • note_id الرقم التعريفي للملاحظة، وهو مُعَامِل إجباري، نوعه عدد صحيح integer.
    • جسم الطلب Body: يكتب بصيغة JSON ويتضمن المُعَامِلات التالية:
      • details: نوعه سلسلة نصية string، يُكتب ضمنه المحتوى النصي المُعَدَّل للملاحظة.
      • attachments: نوعه مصفوفة من الأعداد الصحيحة array، تمرر ضمنه الأرقام التعريفية للمرفقات الجديدة التي تود إضافتها إلى الملاحظة، ولا يعني ذلك حذف المرفقات الموجودة أساسًا ضمن الملاحظة أو استبدالها إنما فقط الإضافة عليها.
        وضحنا سابقًا في مقال "إنشاء ملاحظة جديدة حول استلام معين" طريقة تحميل الملفات إلى خادم زيتون والحصول على أرقامها التعريفية.

    مثال

    سنكتب الطلب التالي لتعديل المحتوى النصي للملاحظة رقم "14" المكتوبة عن الاستلام رقم "291" مع إضافة ملف جديد إلى مرفقاتها ضمن مركز مساعدة تجريبي باسم "المناسب" له النطاق الفرعي al-munasib.zaetoon.com :

    curl -X PUT --header 'Authorization: Bearer your_token' --header 'Content-Type: application/json' --data '{
    "details": "type_your_new_text",
    "attachments": [1428053]
    }' 'https://al-munasib.zaetoon.com/api/agent/v1/form-submissions/291/notes/14'
    محتويات الصفحة