إنشاء صفقة

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