إنشاء تذكرة

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

تُنشئ هذه النقطة تذكرة جديدة، ويمكنها ربط التذكرة بجهات اتصال وصفقات في الطلب نفسه. يحتاج مفتاح واجهة التطبيق البرمجية إلى الإمكانية ticket-create.

ترويسة الطلب

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

محتوى الطلب

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

{
    ticket_name: string,
    contact_ids?: string[],
    deal_ids?: string[],
    [internal_name: string]: any
}
الحقل مطلوب التحققات الوصف
ticket_name مطلوب نص من 3 أحرف على الأقل اسم التذكرة.
contact_ids اختياري مصفوفة من معرّفات جهات اتصال في حسابك جهات الاتصال التي تُربط بالتذكرة.
deal_ids اختياري مصفوفة من معرّفات صفقات في حسابك الصفقات التي تُربط بالتذكرة.
أي خاصية أخرى اختياري يطابق نوع الخاصية استخدم internal_name للخاصية مفتاحاً.

يضع نظام علاقات قيمة _id بنفسه، ويُرفض الطلب الذي يرسلها.

تأخذ الخاصية من نوع single_select، مثل category أو priority، قيمة internal_name لأحد خياراتها:

{
    "ticket_name": "Order not delivered",
    "desc": "The client ordered five days ago and the parcel has not arrived.",
    "category": "general_inquiry",
    "priority": "high",
    "contact_ids": [
        "6650f1a2b3c4d5e6f7a8b901"
    ],
    "deal_ids": [
        "6651a0b1c2d3e4f5a6b7c801"
    ]
}

لربط جهات اتصال أو صفقات بتذكرة موجودة، استخدم ربط جهات الاتصال أو إلغاء ربطها وربط الصفقات أو إلغاء ربطها.

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

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

الإستجابة

201 Created، وتأتي التذكرة الجديدة ضمن data. لا تتضمن الاستجابة جهات الاتصال والصفقات المرتبطة.

{
    "data": {
        "properties": {
            "ticket_name": "Order not delivered",
            "desc": "The client ordered five days ago and the parcel has not arrived.",
            "category": "general_inquiry",
            "priority": "high",
            "created_by": 12,
            "updated_at": "2026-10-20T11:20:00.000000Z",
            "created_at": "2026-10-20T11:20:00.000000Z",
            "_id": "6652b0c1d2e3f4a5b6c7d901"
        }
    },
    "message": "Entity was created successfully."
}

الأخطاء

الرمز المعنى
422 الحقل ticket_name غير موجود أو أقصر من 3 أحرف، أو أحد معرّفات جهات الاتصال أو الصفقات ليس في حسابك، أو قيمة لا تطابق نوع خاصيتها، أو قيمة مفتاح فريد مستخدمة مسبقاً.