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