تعديل شركة

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 قيمة لا تطابق نوع خاصيتها، أو أُرسل حقل يضعه نظام علاقات بنفسه، أو قيمة مفتاح فريد مستخدمة مسبقاً.