POST https://app.alaaqat.com/api/tickets/properties
تُنشئ هذه النقطة خاصية مخصصة للتذاكر. يحتاج مفتاح واجهة التطبيق البرمجية إلى الإمكانية ticket-property-create.
راجع صفحة الخصائص لمعرفة أنواع الخصائص المتاحة وصيغة خيارات الخاصية من نوع single_select.
{
"Accept": "application/json",
"Content-Type": "application/json"
}
{
type: string,
name: {
en?: string,
ar?: string
},
desc?: {
en?: string,
ar?: string
},
internal_name: string,
group_id: string,
enum?: [
{
en?: string,
ar?: string,
internal_name: string
}
],
is_unique_key?: boolean
}
| الحقل | مطلوب | التحققات | الوصف |
|---|---|---|---|
| type | مطلوب | أحد أنواع الخصائص | نوع القيمة التي تحملها الخاصية، ولا يمكن تغييره لاحقاً. |
| name | مطلوب | كائن يضم لغة واحدة على الأقل، وقيمة كل لغة نص | اسم الخاصية بالإنجليزية en أو بالعربية ar أو بكلتيهما. |
| desc | اختياري | كائن من اللغات، وقيمة كل لغة نص أو null |
وصف الخاصية بالإنجليزية أو بالعربية أو بكلتيهما. |
| internal_name | مطلوب | أحرف وأرقام وشرطات سفلية فقط، ولا يجوز أن يبدأ بـ alaaqat، ولا أن تكون خاصية أخرى للتذاكر، مدمجة أو من إنشائك، تستخدمه مسبقاً. |
المفتاح الذي تُحفظ فيه قيمة الخاصية على التذكرة، ولا يمكن تغييره لاحقاً. |
| group_id | مطلوب | قيمة _id لمجموعة خصائص التذاكر، مدمجة أو من إنشائك |
المجموعة التي تظهر الخاصية ضمنها. |
| enum | اختياري | مصفوفة من الخيارات، لكل خيار internal_name لا يتكرر داخل المصفوفة |
خيارات الخاصية من نوع single_select، ولا تُرسل مع الأنواع الأخرى. |
| is_unique_key | اختياري | true أو false |
يجعل الخاصية مفتاحاً فريداً. راجع المفاتيح الفريدة أدناه. |
يملأ نظام علاقات الحقلين account_id وmade_by بنفسه، ويُرفض الطلب الذي يرسل أياً منهما.
خاصية نصية تعمل مفتاحاً فريداً:
{
"type": "string",
"name": {
"en": "Order number",
"ar": "رقم الطلب"
},
"desc": {
"en": "The order the ticket is about",
"ar": "الطلب الذي تتعلق به التذكرة"
},
"internal_name": "order_number",
"group_id": "6653c0d1e2f3a4b5c6d7e801",
"is_unique_key": true
}
خاصية من نوع single_select:
{
"type": "single_select",
"name": {
"en": "Affected service",
"ar": "الخدمة المتأثرة"
},
"internal_name": "affected_service",
"group_id": "6653c0d1e2f3a4b5c6d7e801",
"enum": [
{
"en": "Delivery",
"ar": "التوصيل",
"internal_name": "delivery"
},
{
"en": "Payments",
"ar": "المدفوعات",
"internal_name": "payments"
}
]
}
يمنع المفتاح الفريد أن تحمل تذكرتان القيمة نفسها لهذه الخاصية:
422 مع خطأ على ذلك الحقل. راجع إنشاء تذكرة.422 ما دامت تذكرتان أو أكثر تشتركان في قيمة واحدة لهذه الخاصية. عالج هذا التكرار أولاً ثم فعّل المفتاح.201 Created، وتأتي الخاصية الجديدة ضمن data.
{
"data": {
"type": "string",
"name": {
"en": "Order number",
"ar": "رقم الطلب"
},
"desc": {
"en": "The order the ticket is about",
"ar": "الطلب الذي تتعلق به التذكرة"
},
"internal_name": "order_number",
"group_id": "6653c0d1e2f3a4b5c6d7e801",
"is_unique_key": true,
"account_id": 1024,
"made_by": 12,
"updated_at": "2026-10-20T09:15:00.000000Z",
"created_at": "2026-10-20T09:15:00.000000Z",
"_id": "6654d0e1f2a3b4c5d6e7f801",
"user": {
"id": 12,
"email": "sara.haddad@example.com",
"firstname": "Sara",
"lastname": "Haddad",
"image": null,
"locale": "en",
"created_at": "2026-03-02T08:00:00.000000Z",
"updated_at": "2026-10-01T07:30:00.000000Z",
"fullname": "Sara Haddad"
},
"group": {
"_id": "6653c0d1e2f3a4b5c6d7e801",
"internal_name": "ticket_information",
"name": {
"en": "Ticket Information",
"ar": "معلومات تذكرة الدعم"
},
"desc": [],
"account_id": null,
"made_by": null,
"updated_at": "2026-01-10T00:00:00.000000Z",
"created_at": "2026-01-10T00:00:00.000000Z"
}
},
"message": "Entity was created successfully."
}
| الرمز | المعنى |
|---|---|
| 402 | بلغت الحد الأقصى للخصائص المخصصة في خطتك. اطّلع على الخطط في صفحة الأسعار. |
| 422 | فشل التحقق من أحد الحقول، كأن يكون الاسم الداخلي مستخدماً مسبقاً أو يحتوي على رموز غير مسموحة، أو تكون المجموعة غير موجودة، أو تكون قيمة is_unique_key هي true بينما تشترك التذاكر في قيمة واحدة. |