إنشاء منتج

POST https://app.alaaqat.com/api/products

تُنشئ هذه النقطة منتجاً جديداً. يحتاج مفتاح واجهة التطبيق البرمجية إلى الإمكانية product-create، ويحتاج عضو الفريق الذي أنشأ المفتاح إلى صلاحية إنشاء المنتجات.

ترويسة الطلب

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

محتوى الطلب

محتوى الطلب كائن مسطّح من قيم الخصائص: كل مفتاح فيه هو internal_name لإحدى خصائص المنتجات، مدمجة أو من إنشائك، ويجب أن تطابق كل قيمة نوع خاصيتها. راجع صفحة الخصائص لمعرفة الأنواع، وقائمة خصائص المنتجات لمعرفة الخصائص الموجودة في حسابك. لا توجد خاصية مطلوبة.

{
    name?: string,
    sku?: string,
    price?: number,
    cost?: number,
    status?: string,
    description?: string,
    owner?: number,
    communication_team?: number,
    association_ids?: {
        [object_type: string]: string[]
    },
    [internal_name: string]: any
}
الحقل مطلوب التحققات الوصف
name اختياري نص اسم المنتج.
sku اختياري نص رمز المنتج في المخزون، وهو مفتاح فريد افتراضياً.
price اختياري رقم السعر الذي تبيع به المنتج.
cost اختياري رقم تكلفة المنتج عليك.
status اختياري available أو unavailable هل المنتج متاح للبيع.
description اختياري نص وصف المنتج.
owner اختياري معرّف عضو في الفريق عضو الفريق الذي يملكه.
communication_team اختياري معرّف فريق الفريق الذي ينتمي إليه السجل.
association_ids اختياري كائن من أنواع السجلات، لكل نوع مصفوفة من المعرّفات يربط السجل الجديد بسجلات موجودة. راجع الربط عند الإنشاء.
أي خاصية أخرى اختياري يطابق نوع الخاصية استخدم internal_name للخاصية مفتاحاً.

يضع نظام علاقات _id بنفسه، ويُرفض الطلب الذي يرسلها، وكذلك الطلب الذي يرسل خاصية تحمل "system_only": true.

تقبل خاصية الصورة، مثل image للمنتج، ملف صورة حتى 2 ميغابايت. لتعيينها، أرسل الطلب بصيغة multipart/form-data بدلاً من JSON، وضع الملف تحت internal_name للخاصية.

{
    "name": "Ergonomic office chair",
    "sku": "CH-ERGO-01",
    "price": 120,
    "cost": 74.5,
    "status": "available",
    "description": "Adjustable height and lumbar support, black mesh back.",
    "owner": 12
}

المفاتيح الفريدة

لا يمكن أن يأخذ السجل قيمة يحملها سجل آخر من المنتجات في خاصية تعمل مفتاحاً فريداً. الخاصية sku مفتاح فريد للمنتجات افتراضياً، ويمكنك أن تجعل خصائصك أنت مفاتيح فريدة أيضاً، راجع المفاتيح الفريدة.

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

الربط عند الإنشاء

يربط الحقل association_ids السجل الجديد بسجلات موجودة لديك في الطلب نفسه. كل مفتاح فيه نوع سجل: contact أو company أو deal أو ticket أو product أو invoice، عدا product، وقيمة كل مفتاح مصفوفة من قيم _id لسجلات من ذلك النوع. ويُتجاوز المعرّف الذي لا يعود لسجل في حسابك.

للربط لاحقاً، راجع الارتباطات.

الإستجابة

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

{
    "data": {
        "properties": {
            "_id": "6656b1c2d3e4f5a6b7c8d901",
            "name": "Ergonomic office chair",
            "sku": "CH-ERGO-01",
            "price": 120,
            "cost": 74.5,
            "status": "available",
            "description": "Adjustable height and lumbar support, black mesh back.",
            "owner": 12,
            "created_by": 12,
            "updated_at": "2026-10-20T09:30:00.000000Z",
            "created_at": "2026-10-20T09:30:00.000000Z"
        },
        "account_id": 1024
    },
    "message": "Entity was created successfully."
}

الأخطاء

الرمز المعنى
422 قيمة لا تطابق نوع خاصيتها، أو أُرسل حقل يضعه نظام علاقات بنفسه، أو قيمة مفتاح فريد مستخدمة مسبقاً.