POST https://app.alaaqat.com/api/deals
تُنشئ هذه النقطة صفقة جديدة، ويمكنها ربط الصفقة بجهات اتصال في الطلب نفسه. يحتاج مفتاح واجهة التطبيق البرمجية إلى الإمكانية deal-create.
{
"Accept": "application/json",
"Content-Type": "application/json"
}
محتوى الطلب كائن مسطّح من قيم الخصائص: كل مفتاح فيه هو internal_name لإحدى خصائص الصفقات، مدمجة أو من إنشائك، ويجب أن تطابق كل قيمة نوع خاصيتها. راجع صفحة الخصائص لمعرفة الأنواع.
{
deal_name: string,
contact_ids?: string[],
[internal_name: string]: any
}
| الحقل | مطلوب | التحققات | الوصف |
|---|---|---|---|
| deal_name | مطلوب | نص من 3 أحرف على الأقل | اسم الصفقة. |
| contact_ids | اختياري | مصفوفة من معرّفات جهات اتصال في حسابك | جهات الاتصال التي تُربط بالصفقة. |
| أي خاصية أخرى | اختياري | يطابق نوع الخاصية | استخدم internal_name للخاصية مفتاحاً. |
يضع نظام علاقات قيمة _id بنفسه، ويُرفض الطلب الذي يرسلها.
تأخذ الخاصية من نوع single_select، مثل deal_stage، قيمة internal_name لأحد خياراتها:
{
"deal_name": "Annual support contract",
"amount": 1200,
"deal_stage": "appointment_scheduled",
"contact_ids": [
"6650f1a2b3c4d5e6f7a8b901"
]
}
لربط جهات اتصال بصفقة موجودة، استخدم ربط جهات الاتصال أو إلغاء ربطها.
لا توجد مفاتيح فريدة للصفقات افتراضياً. إذا جعلت إحدى خصائص الصفقات مفتاحاً فريداً، فلا يمكن أن تأخذ الصفقة قيمة تحملها صفقة أخرى في تلك الخاصية: لا تُنشأ الصفقة، ويُرفض الطلب بالرمز 422 مع خطأ على ذلك الحقل.
201 Created، وتأتي الصفقة الجديدة ضمن data. لا تتضمن الاستجابة جهات الاتصال المرتبطة.
{
"data": {
"properties": {
"deal_name": "Annual support contract",
"amount": 1200,
"deal_stage": "appointment_scheduled",
"created_by": 12,
"updated_at": "2026-10-20T10:05:00.000000Z",
"created_at": "2026-10-20T10:05:00.000000Z",
"_id": "6651a0b1c2d3e4f5a6b7c801"
}
},
"message": "Entity was created successfully."
}
| الرمز | المعنى |
|---|---|
| 422 | الحقل deal_name غير موجود أو أقصر من 3 أحرف، أو أحد معرّفات جهات الاتصال ليس في حسابك، أو قيمة لا تطابق نوع خاصيتها، أو قيمة مفتاح فريد مستخدمة مسبقاً. |