يحتوي هذا المستودع على المعاينة العامة لمواصفات OpenAPI 3.1 لواجهة برمجة تطبيقات Discord. حاليًا، المواصفات متاحة فقط لأحدث إصدار من Discord API (الإصدار 10).
️ تخضع المعاينة العامة لمواصفات OpenAPI إلى تغييرات جذرية دون إشعار مسبق، ويجب عدم استخدامها في بيئات الإنتاج.
تم تضمين نسختين من المواصفات — المواصفات القياسية ومواصفات المعاينة:
openapi.json هي المواصفات القياسية التي تحتوي على واجهة برمجة التطبيقات العامة والمستقرة.openapi_preview.json هي مواصفات المعاينة التي تحتوي على ميزات API غير مستقرة و/أو تجريبية. لا ينبغي اعتبار هذا مستقرًا أو مستخدمًا في بيئات الإنتاج.لاستخدام المواصفات مع Postman، يمكنك عرض المجموعة العامة.
يتم إنشاء محتويات مواصفات OpenAPI تلقائيًا، وبالتالي لا نسمح بالمساهمات العامة في هذا الريبو .
؟ للحصول على إصلاحات الأخطاء أو التحسينات، يمكنك فتح مشكلة.
anyOf و oneOf ، إلا أنها جميعًا تعني أنه يمكن استخدام نوع واحد فقط من القائمة كتنسيق بيانات. على سبيل المثال anyOf: {'Cat', 'Dog'} ، لا يزال يعني أنه يمكنك تمرير Cat أو Dog ، وليس Cat+Dog . يتم الإشارة إلى ذلك من خلال الامتداد المخصص x-discord-union: oneOf . نستخدم anyOf عندما لا نتمكن من الناحية الفنية من استخدام oneOf . أحد أسباب القيام بذلك هو على سبيل المثال عندما تكون جميع الحقول اختيارية ويمكن التحقق من صحة البيانات التي تم تمريرها بأكثر من تنسيق واحد.int32 ، كما نتجنب تحديد الحد الأدنى والحد الأقصى المحدد وما إلى ذلك.
