PUT https://app.alaaqat.com/api/tickets/properties/{_id}
حيث _id هو معرّف الخاصية. تغيّر هذه النقطة اسم إحدى خصائص التذاكر أو وصفها أو مجموعتها أو خياراتها أو إعداد المفتاح الفريد فيها. يحتاج مفتاح واجهة التطبيق البرمجية إلى الإمكانية ticket-property-update.
{
"Accept": "application/json",
"Content-Type": "application/json"
}
{
name: {
en?: string,
ar?: string
},
desc?: {
en?: string,
ar?: string
},
group_id: string,
enum?: [
{
en?: string,
ar?: string,
internal_name: string
}
],
is_unique_key?: boolean
}
| الحقل | مطلوب | التحققات | الوصف |
|---|---|---|---|
| name | مطلوب | كائن يضم لغة واحدة على الأقل، وقيمة كل لغة نص | اسم الخاصية بالإنجليزية en أو بالعربية ar أو بكلتيهما. |
| desc | اختياري | كائن من اللغات، وقيمة كل لغة نص أو null |
وصف الخاصية بالإنجليزية أو بالعربية أو بكلتيهما. |
| group_id | مطلوب | قيمة _id لمجموعة خصائص التذاكر، مدمجة أو من إنشائك |
المجموعة التي تظهر الخاصية ضمنها. |
| enum | اختياري | مصفوفة من الخيارات، لكل خيار internal_name لا يتكرر داخل المصفوفة |
خيارات الخاصية من نوع single_select. تحل القائمة المرسلة محل القائمة الحالية، فأرسل كل خيار تريد الإبقاء عليه. |
| is_unique_key | اختياري | true أو false |
يفعّل المفتاح الفريد أو يلغيه. يُرفض التفعيل ما دامت تذكرتان أو أكثر تشتركان في قيمة واحدة لهذه الخاصية، راجع المفاتيح الفريدة. أما الإلغاء فمقبول دائماً. |
لا يمكن تغيير type ولا internal_name بعد إنشاء الخاصية، ويُرفض الطلب الذي يرسل أياً منهما بالرمز 422، فلا ترسلهما.
إضافة خيار ثالث إلى خاصية من نوع single_select:
{
"name": {
"en": "Affected service",
"ar": "الخدمة المتأثرة"
},
"desc": {
"en": "The service the client reports a problem with",
"ar": "الخدمة التي يبلّغ العميل عن مشكلة فيها"
},
"group_id": "6653c0d1e2f3a4b5c6d7e801",
"enum": [
{
"en": "Delivery",
"ar": "التوصيل",
"internal_name": "delivery"
},
{
"en": "Payments",
"ar": "المدفوعات",
"internal_name": "payments"
},
{
"en": "Returns",
"ar": "الإرجاع",
"internal_name": "returns"
}
]
}
يمكنك كذلك تحديث إحدى خصائص التذاكر المدمجة. يحفظ نظام علاقات تعديلاتك في نسخة خاصة بحسابك من تلك الخاصية: تحمل الاستجابة قيمة _id للنسخة، وتظهر النسخة في قائمة الخصائص من ذلك الحين. أي تحديث لاحق، سواء أرسلته إلى المعرّف الأصلي أم إلى معرّف النسخة، يعدّل النسخة نفسها.
الخاصية التي تحمل "system_only": true يملأ نظام علاقات قيمها بنفسه، فلا يمكن تحديثها، ويُرفض الطلب بالرمز 403.
200 OK، وتأتي الخاصية المحدّثة ضمن data.
{
"data": {
"_id": "6654d0e1f2a3b4c5d6e7f802",
"type": "single_select",
"name": {
"en": "Affected service",
"ar": "الخدمة المتأثرة"
},
"desc": {
"en": "The service the client reports a problem with",
"ar": "الخدمة التي يبلّغ العميل عن مشكلة فيها"
},
"internal_name": "affected_service",
"group_id": "6653c0d1e2f3a4b5c6d7e801",
"enum": [
{
"en": "Delivery",
"ar": "التوصيل",
"internal_name": "delivery"
},
{
"en": "Payments",
"ar": "المدفوعات",
"internal_name": "payments"
},
{
"en": "Returns",
"ar": "الإرجاع",
"internal_name": "returns"
}
],
"is_unique_key": false,
"account_id": 1024,
"made_by": 12,
"updated_at": "2026-10-21T08:40:12.000000Z",
"created_at": "2026-10-20T09:15:00.000000Z",
"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 modified successfully."
}
| الرمز | المعنى |
|---|---|
| 403 | الخاصية تحمل "system_only": true. |
| 422 | فشل التحقق من أحد الحقول، كأن يُرسل type أو internal_name، أو تكون المجموعة غير موجودة، أو تكون قيمة is_unique_key هي true بينما تشترك التذاكر في قيمة واحدة. |