Data types
TypeSpec.OpenAPI
AdditionalInfo
Additional information for the OpenAPI document.
model TypeSpec.OpenAPI.AdditionalInfoProperties
| Name | Type | Description |
|---|---|---|
| title? | string | The title of the API. Overrides the @service title. |
| summary? | string | A short summary of the API. Overrides the @summary provided on the service namespace. |
| version? | string | The version of the OpenAPI document (which is distinct from the OpenAPI Specification version or the API implementation version). |
| termsOfService? | url | A URL to the Terms of Service for the API. MUST be in the format of a URL. |
| contact? | Contact | The contact information for the exposed API. |
| license? | License | The license information for the exposed API. |
Contact
Contact information for the exposed API.
model TypeSpec.OpenAPI.ContactProperties
| Name | Type | Description |
|---|---|---|
| name? | string | The identifying name of the contact person/organization. |
| url? | url | The URL pointing to the contact information. MUST be in the format of a URL. |
| email? | string | The email address of the contact person/organization. MUST be in the format of an email address. |
License
License information for the exposed API.
model TypeSpec.OpenAPI.LicenseProperties
| Name | Type | Description |
|---|---|---|
| name | string | The license name used for the API. |
| url? | url | A URL to the license used for the API. MUST be in the format of a URL. |