إضافة ملاحظة إلى شركة

POST https://app.alaaqat.com/api/companies/{company_id}/notes

حيث company_id هو قيمة _id للشركة. تضيف هذه النقطة ملاحظة إلى السجل، وتُكتب الملاحظة باسم عضو الفريق الذي أنشأ المفتاح. يحتاج مفتاح واجهة التطبيق البرمجية إلى الإمكانية company-note-create، ويحتاج عضو الفريق الذي أنشأ المفتاح إلى صلاحية إضافة ملاحظة على الشركة.

ترويسة الطلب

{
    "Accept": "application/json",
    "Content-Type": "application/json"
}

محتوى الطلب

{
    description: string
}
الحقل مطلوب التحققات الوصف
description مطلوب نص نص الملاحظة.
{
    "description": "تواصلنا لتأكيد التجديد السنوي، وطلب قسم المشتريات قائمة الأسعار المحدّثة."
}

الإستجابة

201 Created، وتأتي الملاحظة الجديدة ضمن data.

{
    "data": {
        "_id": "6658d1e2f3a4b5c6d7e8f901",
        "description": "تواصلنا لتأكيد التجديد السنوي، وطلب قسم المشتريات قائمة الأسعار المحدّثة.",
        "company_id": "6655a1b2c3d4e5f6a7b8c901",
        "made_by": 12,
        "updated_at": "2026-10-20T09:30:00.000000Z",
        "created_at": "2026-10-20T09:30:00.000000Z"
    },
    "message": "Entity was created successfully."
}

الأخطاء

الرمز المعنى
402 وصل حسابك إلى حد الملاحظات في باقتك. راجع الباقات في صفحة الأسعار.
422 الحقل description غير موجود أو ليس نصاً.