PUT https://app.alaaqat.com/api/companies/{company_id}
حيث company_id هو قيمة _id للشركة. تغيّر هذه النقطة قيم الخصائص التي ترسلها، وتبقى الخصائص الأخرى كما هي. يحتاج مفتاح واجهة التطبيق البرمجية إلى الإمكانية company-update، ويحتاج عضو الفريق الذي أنشأ المفتاح إلى صلاحية تعديل معلومات الشركة.
{
"Accept": "application/json",
"Content-Type": "application/json"
}
قيم الخصائص نفسها المذكورة في إنشاء شركة: كل مفتاح هو internal_name لخاصية، ويجب أن تطابق كل قيمة نوعها. أرسل الخصائص التي تريد تغييرها فقط، ولإفراغ قيمة أرسل null.
{
"num_employees": 52,
"lifecycle_stage": "customer",
"city": "Amman"
}
إذا كانت إحدى الخصائص المرسلة مفتاحاً فريداً، فيجب ألا تكون قيمتها لسجل آخر من الشركات. وإلا لا يُعدَّل شيء، ويُرفض الطلب بالرمز 422 مع خطأ على ذلك الحقل.
200 OK، ويأتي السجل كاملاً ضمن data.
{
"data": {
"properties": {
"_id": "6655a1b2c3d4e5f6a7b8c901",
"name": "Blue Harbor Trading",
"website_url": "https://blueharbor.example.com",
"industry": "Wholesale",
"city": "Amman",
"country_region": "Jordan",
"phone": "96265000000",
"num_employees": 52,
"lifecycle_stage": "customer",
"owner": 12,
"created_by": 12,
"updated_at": "2026-10-21T08:40:12.000000Z",
"created_at": "2026-10-20T09:30:00.000000Z"
},
"account_id": 1024
},
"message": "Entity was modified successfully."
}
| الرمز | المعنى |
|---|---|
| 403 | عضو الفريق الذي أنشأ المفتاح لا يستطيع تعديل إلا الشركات التي يملكها هو أو فرقه، وهذا السجل ليس منها. |
| 404 | لا يوجد في حسابك سجل بقيمة _id هذه. |
| 422 | قيمة لا تطابق نوع خاصيتها، أو أُرسل حقل يضعه نظام علاقات بنفسه، أو قيمة مفتاح فريد مستخدمة مسبقاً. |