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