التعديل المتعدد للشركات

قد تحتاج لتعديل إعدادات عدة شركات دفعة واحدة وهو ما سنشرحه اليوم من خلال مثال عملي على مركز مساعدة تجريبي يدعى "المناسب al-munasib" له النطاق الفرعي al-munasib.zaetoon.com.

التعديل المتعدد للشركات

تسمح لك نقطة الاتصال companies/ بالتعديل المتعدد لمجموعة شركات دفعة واحدة، ويشمل تعديل الإعدادات التالية:

• إضافة أو حذف الوسوم من الشركات المُحَدَّدة.
• إسناد الشركات المُحَدَّدة إلى مستخدم معين.
• تغيير حالة الشركات المُحَدَّدة.

وذلك كما يلي:

• عنوان URL لنقطة الاتصال:
  https://{your_subdomain}/api/agent/v1/companies.
• نوع الطلب: PUT.
• جسم الطلب Body: يُكتب بصيغة JSON ويتضمن المعاملات التالية:
• • company_ids: معامل إجباري، نوعه مصفوفة أعداد صحيحة array، تُمَرَّر ضمنه الأرقام التعريفية للشركات المطلوب تعديلها.
  • added_tags: نوعه مصفوفة سلاسل نصية array، تكتب ضمنه مجموعة الوسوم المطلوب إضافتها إلى مجموعة الشركات المُحَدَّدة.
  • deleted_tags:نوعه مصفوفة سلاسل نصية array، تكتب ضمنه مجموعة الوسوم المطلوب حذفها من مجموعة الشركات المُحَدَّدة.
  • assign_to: نوعه عدد صحيح integer، يساعدك على إسناد الشركات المُحَدَّدة إلى مستخدم معين بناءً على رقمه التعريفي id.
  • status: نوعه سلسلة نصية string، يساعدك على تعديل حالة الشركات المُحَدَّدة ويقبل إحدى القيم التالية حصرًا:
  • • active فعَّالة.
    • inactive غير فعَّالة.
    • deleted محذوفة.

مثال

لاحظ المثال التالي للتعديل المتعدد على ثلاث شركات في مركز مساعدة "المناسب" "al-munasib" يتضمن:

1. إضافة الوسم "مهمة" إلى الشركات الثلاث.
2. حذف الوسم "جديدة" منها.
3. إسناد الشركات الثلاث إلى المستخدم ذو الرقم التعريفي "1434".
4. تعديل حالة الشركات لتصبح "فعّالة" "active".

curl -X PUT --header 'Authorization: Bearer your_token' 'Content-Type: application/json' --data '{
    "company_ids": [222, 242, 247],
    "added_tags" : ["مهمة"],
    "deleted_tags": ["جديدة"],
    "assign_to": 1434,
    "status": "active"
}' 'https://al-munasib.zaetoon.com/api/agent/v1/companies'