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

tsoa-next / @tsoa-next/cli / ExtendedSpecConfig

Interface: ExtendedSpecConfig

محددة في: cli/src/api.ts:387

الثقوب المطبعية عادت validateSpecConfig.

التذييلات

  • SpecConfig

الممتلكات

basePath?

ts
optional basePath?: string;

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

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

Inherited from

ts
SpecConfig.basePath

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

Inherited from

ts
SpecConfig.contact

controllerPathGlobs?

ts
optional controllerPathGlobs?: string[];

محددة في: cli/src/api.ts:390


description?

ts
optional description?: string;

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

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

Inherited from

ts
SpecConfig.description

disableBasePathPrefixSlash?

ts
optional disableBasePathPrefixSlash?: boolean;

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

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

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

Inherited from

ts
SpecConfig.disableBasePathPrefixSlash

entryFile

ts
entryFile: string;

محددة في: cli/src/api.ts:388


host?

ts
optional host?: string;

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

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

Inherited from

ts
SpecConfig.host

license?

ts
optional license?: string;

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

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

Inherited from

ts
SpecConfig.license

name?

ts
optional name?: string;

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

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

Inherited from

ts
SpecConfig.name

noImplicitAdditionalProperties

ts
noImplicitAdditionalProperties: "ignore" | "throw-on-extras" | "silently-remove-extras";

محددة في: cli/src/api.ts:389


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}}'

Inherited from

ts
SpecConfig.operationIdTemplate

outputDirectory

ts
outputDirectory: string;

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

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

Inherited from

ts
SpecConfig.outputDirectory

rootSecurity?

ts
optional rootSecurity?: Security[];

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

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

Inherited from

ts
SpecConfig.rootSecurity

schemes?

ts
optional schemes?: Protocol[];

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

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

Inherited from

ts
SpecConfig.schemes

securityDefinitions?

ts
optional securityDefinitions?: object;

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

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

مؤشر التوقيع

ts
[name: string]: SecuritySchemes

Inherited from

ts
SpecConfig.securityDefinitions

servers?

ts
optional servers?: string[];

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

خادم OpenAPI 3 ناتج

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

Inherited from

ts
SpecConfig.servers

spec?

ts
optional spec?: unknown;

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

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

Inherited from

ts
SpecConfig.spec

specFileBaseName?

ts
optional specFileBaseName?: string;

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

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

@default: "سواغر"

Inherited from

ts
SpecConfig.specFileBaseName

specMerging?

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

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

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

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

Default

ts
'immediate'

Inherited from

ts
SpecConfig.specMerging

specVersion?

ts
optional specVersion?: SupportedSpecMajorVersion;

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

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

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

Inherited from

ts
SpecConfig.specVersion

tags?

ts
optional tags?: Tag[];

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

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

Inherited from

ts
SpecConfig.tags

termsOfService?

ts
optional termsOfService?: string;

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

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

Inherited from

ts
SpecConfig.termsOfService

useTitleTagsForInlineObjects?

ts
optional useTitleTagsForInlineObjects?: boolean;

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

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

Inherited from

ts
SpecConfig.useTitleTagsForInlineObjects

version?

ts
optional version?: string;

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

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

Inherited from

ts
SpecConfig.version

xEnumVarnames?

ts
optional xEnumVarnames?: boolean;

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

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

Default

ts
false

Inherited from

ts
SpecConfig.xEnumVarnames

yaml?

ts
optional yaml?: boolean;

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

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

Inherited from

ts
SpecConfig.yaml

Contributors

No contributors

Changelog

No recent changes

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