تعريف خاصية بدون اسم في Swagger

لتحديد خاصية في Swagger لا تحتوي على اسم معروف، يمكنك استخدام النمط “additionalProperties” مع “patternProperties” لتحديد نمط الأسماء التي قد تكون للخاصيات غير المعروفة. في هذه الحالة، يمكنك استخدام نمط يوافق أي عدد صحيح. هنا هو كيف يمكن تعريف هذه الخاصية في Swagger:

jsonCopy code
{
  "type": "object",
  "additionalProperties": {
    "type": "array",
    "items": { "$ref": "#/definitions/ModelRelease" }
  },
  "patternProperties": {
    "^[0-9]+$": {
      "type": "array",
      "items": { "$ref": "#/definitions/ModelRelease" }
    }
  }
}

في هذا المثال، “additionalProperties” تحدد نوع القيم التي ليس لها اسم محدد، و “patternProperties” تحدد النمط الذي يجب أن تتبعه الأسماء المحتملة لهذه الخاصية (في هذه الحالة، أي عدد صحيح).

بالطبع! في Swagger، يمكنك استخدام “additionalProperties” لتحديد خاصية ليس لها اسم محدد، ولكن يجب تحديد نوع القيمة التي ستكون لهذه الخاصية. في حالة الرغبة في تحديد أسماء محتملة لهذه الخاصية، يمكنك استخدام “patternProperties” بالاشتراط أن يكون نوع الخاصية هو “object”، وتوفير نمط الأسماء المحتملة كتعبيرات منتظمة.

عند استخدام “additionalProperties” و “patternProperties”، يجب مراعاة النقاط التالية:

1. “additionalProperties”: يحدد نوع القيم التي تكون للخاصية التي ليس لها اسم محدد. يمكن أن يكون نوع القيمة أي نوع مدعوم في Swagger (مثل “string”، “integer”، “array”، إلخ).

2. “patternProperties”: يحدد النمط الذي يجب أن تتبعه الأسماء المحتملة لهذه الخاصية. يتم تحديد النمط باستخدام تعبير منتظم (regex). عند توافق اسم الخاصية مع أحد الأنماط، يجب أن تكون قيمتها من نوع “object” وتحتوي على تعريف لنوع القيمة.

على سبيل المثال، إذا كنت تريد تحديد خاصية تسمى “dynamicProperties” تحتوي على قيم من نوع “integer”، يمكنك استخدام التعريف التالي في Swagger:

jsonCopy code
{
  "type": "object",
  "additionalProperties": false,
  "patternProperties": {
    "^[a-zA-Z0-9]+$": {
      "type": "integer"
    }
  }
}

في هذا المثال، يمنع “additionalProperties” وجود خاصيات إضافية غير محددة مسبقًا، و “patternProperties” يحدد أن الأسماء المحتملة للخاصية يجب أن تتوافق مع أي سلسلة تحتوي على أحرف وأرقام، وتحدد نوع القيمة لتكون من نوع “integer”.