تخطي إلى المحتوى

tsoa-next / tsoa-next / SpecConfig

Interface: SpecConfig

محددة في: packages/runtime/src/config.ts:79

OpenAPI أجيال

الممتلكات

basePath?

ts
optional basePath?: string;

محددة في: packages/runtime/src/config.ts:163

طريق الـ "بي آي" في القاعدة، مثل "إف 1" https://myapi.com/v1


contact?

ts
optional contact?: object;

محددة في: packages/runtime/src/config.ts:135

Contact information for the published API.

email?

ts
optional email?: string;

عنوان البريد الإلكتروني لشخص/تنظيم الاتصال.

Default
ts
npm package author email

name?

ts
optional name?: string;

The identifying name of the contact person/organization.

Default
ts
npm package author

url?

ts
optional url?: string;

URL pointing to the contact information.

Default
ts
npm package author url

description?

ts
optional description?: string;

محددة في: packages/runtime/src/config.ts:124

وصف طلب الموافقة المسبقة عن علم؛ npm وصف


disableBasePathPrefixSlash?

ts
optional disableBasePathPrefixSlash?: boolean;

محددة في: packages/runtime/src/config.ts:170

الضوابط على ما إذا كانت basePath تم تحديدها مسبقاً / عند تكوينها OpenAPI 3 خوادم

فقط متاحة بنسخة 3 أو 3-1.


host?

ts
optional host?: string;

محددة في: packages/runtime/src/config.ts:88

اسم البلد المضيف Swagger ناتجان على سبيل المثال localhost:3000.


license?

ts
optional license?: string;

محددة في: packages/runtime/src/config.ts:158

رخصـة الرخصـة المرفـقـة؛ npm حزمة ترخيص عند وجودها


name?

ts
optional name?: string;

محددة في: packages/runtime/src/config.ts:119

اسم API؛ التقصير إلى npm الاسم


operationIdTemplate?

ts
optional operationIdTemplate?: string;

محددة في: packages/runtime/src/config.ts:197

سلسلة نموذجية لتوليد العمليات This should be a valid handlebars template and is provided مع السياق التالي:

  • راكب اسم "سترينج" لفصل المتحكمين
  • تسو هدف مُحدّد.

Default

ts
'{{titleCase method.name}}'

outputDirectory

ts
outputDirectory: string;

محددة في: packages/runtime/src/config.ts:83

دليل أين يجب أن يكتب ملف المواصفات


rootSecurity?

ts
optional rootSecurity?: Security[];

محددة في: packages/runtime/src/config.ts:232

يُطبّقُ أمناً خاطئاً إلى كامل مكتب التحقيقات الفدرالي. يمكن أن تكون مغمورة @Security(...) أو @NoSecurity() مصممون على أجهزة التحكم أو الأساليب


schemes?

ts
optional schemes?: Protocol[];

محددة في: packages/runtime/src/config.ts:215

البروتوكولات الداعمة Swagger ناتجان.


securityDefinitions?

ts
optional securityDefinitions?: object;

محددة في: packages/runtime/src/config.ts:202

مخططات الأمن المعلنة للمواصفات.

مؤشر التوقيع

ts
[name: string]: SecuritySchemes

servers?

ts
optional servers?: string[];

محددة في: packages/runtime/src/config.ts:95

خادم OpenAPI 3 ناتج

فقط متاحة بنسخة 3 أو 3-1.


spec?

ts
optional spec?: unknown;

محددة في: packages/runtime/src/config.ts:176

اخترقت المواصفات المتولدة وتتمتع الممتلكات المولدة دائما بالأسبقية على القيم المقدمة هنا.


specFileBaseName?

ts
optional specFileBaseName?: string;

محددة في: packages/runtime/src/config.ts:102

لقب (سواغر) (جيسون) أو (سواغر) يامل

@default: "سواغر"


specMerging?

ts
optional specMerging?: "recursive" | "immediate" | "deepmerge";

محددة في: packages/runtime/src/config.ts:186

التحكم كيف spec يتم دمجه في الوثيقة المتولدة القيم المحتملة:

  • 'مسرعة تجاوزات فقط العناصر العليا.
  • "التكرار يؤدي دوراً عميقاً" merge.
  • (ديبميرج) يقوم بدمج عميق ts-deepmergeبما في ذلك الصفوف

Default

ts
'immediate'

specVersion?

ts
optional specVersion?: SupportedSpecMajorVersion;

محددة في: packages/runtime/src/config.ts:114

الرائد OpenAPI إصدارات لتوليدها؛ تقصير في الصيغة 2 عندما لا يحدد القيم المحتملة:

  • 2 - المولدات OpenAPI نسخة 2.
  • 3 - المولدات OpenAPI نسخة 3
  • 3-1: المولدات OpenAPI الصيغة 3-1.

tags?

ts
optional tags?: Tag[];

محددة في: packages/runtime/src/config.ts:209

البيانات الوصفية على المستوى الرفيع للمواصفات المتولدة.


termsOfService?

ts
optional termsOfService?: string;

محددة في: packages/runtime/src/config.ts:130

ربط الصفحة التي تصف شروط الخدمة. يجب أن يكون في شكل URL.


useTitleTagsForInlineObjects?

ts
optional useTitleTagsForInlineObjects?: boolean;

محددة في: packages/runtime/src/config.ts:226

يضاف عناوين للرد الخطي وخصائص الجسم الطلبي لتحسين توليد العملاء.


version?

ts
optional version?: string;

محددة في: packages/runtime/src/config.ts:105

نسخة من نظام المعلومات الإدارية المتكامل؛ التقصير في صيغة الطرد.


xEnumVarnames?

ts
optional xEnumVarnames?: boolean;

محددة في: packages/runtime/src/config.ts:221

الدعم الممكّن من استخدام الأسماء من الفئة " X-enum "

Default

ts
false

yaml?

ts
optional yaml?: boolean;

محددة في: packages/runtime/src/config.ts:212

يكتب المواصفات المتولدة كـ(يام إل) بدلاً من (جيون)

Contributors

No contributors

Changelog

No recent changes

توليد OpenAPI وتوليد المسارات والتحقق وقت التشغيل مع اعتماد TypeScript أولاً.