إضافة العنصر التفاعلي

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

عرض عنصر تفاعلي

لعرض كافة إعدادات العنصر التفاعلي الذي له الرقم التعريفي 101، نكتب الطلب التالي:

curl "https://example.com/api/agent/v1/focus-items/101" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN"

إضافة عنصر تفاعلي

لإضافة عنصر تفاعلي كشريط ثابت في الموقع بإسم شريط إعلاني نُرسل الطلب التالي:

curl "https://example.com/api/agent/v1/focus-items" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "شريط إعلاني",
    "type": "bar",
    "status": "active",
    "style": {
      "background_color": "#ffffff",
      "close_button": true
    },
    "content": {
      "text": "احصل على أفضل الخصومات"
    }
  }'

تعديل عنصر تفاعلي

على سبيل المثال لإخفاء العنصر التفاعلي رقم 101 نرسل الطلب التالي:

curl "https://example.com/api/agent/v1/focus-items/101" \
  -X PATCH \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "inactive"
  }'

حذف عنصر تفاعلي

لحذف العنصر التفاعلي رقم 101 نرسل الطلب التالي:

curl "https://example.com/api/agent/v1/focus-items/101" \
  -X DELETE \
  -H "Authorization: Bearer $TOKEN"

لاستعادة نفس العنصر التفاعلي نُرسل الطلب التالي:

curl "https://example.com/api/agent/v1/focus-items/101/restore" \
  -X POST \
  -H "Authorization: Bearer $TOKEN"

إقرأ أيضاً

• الإتصال بالواجهة البرمجية