@sonatype/nexus-iq-api-client 0.175.0 → 0.176.0

package/src/apis/RolesApi.ts

@@ -4,7 +4,7 @@
  * Sonatype Lifecycle Public REST API
  * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
  *
- * The version of the OpenAPI document: 1.175.0-01
+ * The version of the OpenAPI document: 1.176.0-01
  * 
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/src/apis/SbomApi.ts

@@ -4,7 +4,7 @@
  * Sonatype Lifecycle Public REST API
  * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
  *
- * The version of the OpenAPI document: 1.175.0-01
+ * The version of the OpenAPI document: 1.176.0-01
  * 
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -15,16 +15,19 @@
 
 import * as runtime from '../runtime';
 import type {
+  ApiSbomApplicationsHistoryMetricDTO,
   ImportSbomRequest,
 } from '../models/index';
 import {
+    ApiSbomApplicationsHistoryMetricDTOFromJSON,
+    ApiSbomApplicationsHistoryMetricDTOToJSON,
     ImportSbomRequestFromJSON,
     ImportSbomRequestToJSON,
 } from '../models/index';
 
 export interface DeleteSbomVersionRequest {
     applicationId: string;
-    sbomVersion: string;
+    version: string;
 }
 
 export interface GetImportStatusRequest {
@@ -32,21 +35,21 @@ export interface GetImportStatusRequest {
     importRequestId: string;
 }
 
-export interface GetListOfSbomsForApplicationIdRequest {
+export interface GetSbomComponentsRequest {
     applicationId: string;
-    sortByDate?: string;
-    pageSize?: number;
-    page?: number;
+    version: string;
 }
 
-export interface GetSbomComponentsRequest {
+export interface GetSbomMetadataSummaryForApplicationRequest {
     applicationId: string;
-    sbomVersion: string;
+    sortByDate?: string;
+    pageSize?: number;
+    page?: number;
 }
 
 export interface GetSbomVersionRequest {
     applicationId: string;
-    sbomVersion: string;
+    version: string;
     state?: string;
     accept?: string;
 }
@@ -70,7 +73,7 @@ export interface SbomApiInterface {
      * Deletes a specific sbom version including it\'s original contents and updates
      * @summary Delete sbom version
      * @param {string} applicationId The internal id of the application
-     * @param {string} sbomVersion URL Encoded version value of the sbom to be deleted
+     * @param {string} version URL Encoded version value of the sbom to be deleted
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof SbomApiInterface
@@ -83,6 +86,18 @@ export interface SbomApiInterface {
      */
     deleteSbomVersion(requestParameters: DeleteSbomVersionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
 
+    /**
+     * 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof SbomApiInterface
+     */
+    getApplicationsHistoryMetricRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ApiSbomApplicationsHistoryMetricDTO>>;
+
+    /**
+     */
+    getApplicationsHistoryMetric(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ApiSbomApplicationsHistoryMetricDTO>;
+
     /**
      * Gets status of a sbom import.
      * @summary Get sbom import status
@@ -101,46 +116,46 @@ export interface SbomApiInterface {
     getImportStatus(requestParameters: GetImportStatusRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
 
     /**
-     * Gets a paginated list of SBOMs for an application
-     * @summary Gets a paginated list of SBOMs for an application
+     * Lists the components in a specific sbom version with data about vulnerabilities and licenses
+     * @summary Gets the components found in a specific sbom version
      * @param {string} applicationId The internal id of the application
-     * @param {string} [sortByDate] Sort results by import date. Allowed values [asc|desc]. default &#x3D; asc
-     * @param {number} [pageSize] Number of items to return by page. default &#x3D; 10
-     * @param {number} [page] Current page number. default &#x3D; 1
+     * @param {string} version URL Encoded version value of the sbom to query its components
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof SbomApiInterface
      */
-    getListOfSbomsForApplicationIdRaw(requestParameters: GetListOfSbomsForApplicationIdRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+    getSbomComponentsRaw(requestParameters: GetSbomComponentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
 
     /**
-     * Gets a paginated list of SBOMs for an application
-     * Gets a paginated list of SBOMs for an application
+     * Lists the components in a specific sbom version with data about vulnerabilities and licenses
+     * Gets the components found in a specific sbom version
      */
-    getListOfSbomsForApplicationId(requestParameters: GetListOfSbomsForApplicationIdRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    getSbomComponents(requestParameters: GetSbomComponentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
 
     /**
-     * Lists the components in a specific sbom version with data about vulnerabilities and licenses
-     * @summary Gets the components found in a specific sbom version
+     * Gets a paginated list of SBOMs for an application
+     * @summary Gets a paginated list of SBOMs for an application
      * @param {string} applicationId The internal id of the application
-     * @param {string} sbomVersion URL Encoded version value of the sbom to query its components
+     * @param {string} [sortByDate] Sort results by import date. Allowed values [asc|desc]. default &#x3D; asc
+     * @param {number} [pageSize] Number of items to return by page. default &#x3D; 10
+     * @param {number} [page] Current page number. default &#x3D; 1
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof SbomApiInterface
      */
-    getSbomComponentsRaw(requestParameters: GetSbomComponentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+    getSbomMetadataSummaryForApplicationRaw(requestParameters: GetSbomMetadataSummaryForApplicationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
 
     /**
-     * Lists the components in a specific sbom version with data about vulnerabilities and licenses
-     * Gets the components found in a specific sbom version
+     * Gets a paginated list of SBOMs for an application
+     * Gets a paginated list of SBOMs for an application
      */
-    getSbomComponents(requestParameters: GetSbomComponentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    getSbomMetadataSummaryForApplication(requestParameters: GetSbomMetadataSummaryForApplicationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
 
     /**
      * Downloads a specific sbom version in its original or current form
      * @summary Gets a sbom version
      * @param {string} applicationId The internal id of the application
-     * @param {string} sbomVersion URL Encoded version value of the sbom
+     * @param {string} version URL Encoded version value of the sbom
      * @param {string} [state] The state of the sbom version. Allowed values [original|current]. default &#x3D; current
      * @param {string} [accept] Output format(json/xml) of the sbom. Changing the output format only applicable when downloading the current form of the SBOM. The original sbom will always return in the original form that it was ingested. When requesting &#x60;current&#x60; form and if this header value is not present the sbom will be returned in its original ingested format. Allowed values {\&#39;application/json\&#39;|\&#39;application/xml\&#39;}. default &#x3D; null
      * @param {*} [options] Override http request option.
@@ -203,8 +218,8 @@ export class SbomApi extends runtime.BaseAPI implements SbomApiInterface {
             throw new runtime.RequiredError('applicationId','Required parameter requestParameters.applicationId was null or undefined when calling deleteSbomVersion.');
         }
 
-        if (requestParameters.sbomVersion === null || requestParameters.sbomVersion === undefined) {
-            throw new runtime.RequiredError('sbomVersion','Required parameter requestParameters.sbomVersion was null or undefined when calling deleteSbomVersion.');
+        if (requestParameters.version === null || requestParameters.version === undefined) {
+            throw new runtime.RequiredError('version','Required parameter requestParameters.version was null or undefined when calling deleteSbomVersion.');
         }
 
         const queryParameters: any = {};
@@ -215,7 +230,7 @@ export class SbomApi extends runtime.BaseAPI implements SbomApiInterface {
             headerParameters["Authorization"] = "Basic " + btoa(this.configuration.username + ":" + this.configuration.password);
         }
         const response = await this.request({
-            path: `/api/v2/sbom/{applicationId}/version/{sbomVersion}`.replace(`{${"applicationId"}}`, encodeURIComponent(String(requestParameters.applicationId))).replace(`{${"sbomVersion"}}`, encodeURIComponent(String(requestParameters.sbomVersion))),
+            path: `/api/v2/sbom/applications/{applicationId}/versions/{version}`.replace(`{${"applicationId"}}`, encodeURIComponent(String(requestParameters.applicationId))).replace(`{${"version"}}`, encodeURIComponent(String(requestParameters.version))),
             method: 'DELETE',
             headers: headerParameters,
             query: queryParameters,
@@ -232,6 +247,33 @@ export class SbomApi extends runtime.BaseAPI implements SbomApiInterface {
         await this.deleteSbomVersionRaw(requestParameters, initOverrides);
     }
 
+    /**
+     */
+    async getApplicationsHistoryMetricRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ApiSbomApplicationsHistoryMetricDTO>> {
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && (this.configuration.username !== undefined || this.configuration.password !== undefined)) {
+            headerParameters["Authorization"] = "Basic " + btoa(this.configuration.username + ":" + this.configuration.password);
+        }
+        const response = await this.request({
+            path: `/api/v2/sbom/dashboard/sbomsHistoryMetrics`,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => ApiSbomApplicationsHistoryMetricDTOFromJSON(jsonValue));
+    }
+
+    /**
+     */
+    async getApplicationsHistoryMetric(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ApiSbomApplicationsHistoryMetricDTO> {
+        const response = await this.getApplicationsHistoryMetricRaw(initOverrides);
+        return await response.value();
+    }
+
     /**
      * Gets status of a sbom import.
      * Get sbom import status
@@ -253,7 +295,7 @@ export class SbomApi extends runtime.BaseAPI implements SbomApiInterface {
             headerParameters["Authorization"] = "Basic " + btoa(this.configuration.username + ":" + this.configuration.password);
         }
         const response = await this.request({
-            path: `/api/v2/sbom/{applicationId}/status/{importRequestId}`.replace(`{${"applicationId"}}`, encodeURIComponent(String(requestParameters.applicationId))).replace(`{${"importRequestId"}}`, encodeURIComponent(String(requestParameters.importRequestId))),
+            path: `/api/v2/sbom/applications/{applicationId}/status/{importRequestId}`.replace(`{${"applicationId"}}`, encodeURIComponent(String(requestParameters.applicationId))).replace(`{${"importRequestId"}}`, encodeURIComponent(String(requestParameters.importRequestId))),
             method: 'GET',
             headers: headerParameters,
             query: queryParameters,
@@ -271,27 +313,19 @@ export class SbomApi extends runtime.BaseAPI implements SbomApiInterface {
     }
 
     /**
-     * Gets a paginated list of SBOMs for an application
-     * Gets a paginated list of SBOMs for an application
+     * Lists the components in a specific sbom version with data about vulnerabilities and licenses
+     * Gets the components found in a specific sbom version
      */
-    async getListOfSbomsForApplicationIdRaw(requestParameters: GetListOfSbomsForApplicationIdRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>> {
+    async getSbomComponentsRaw(requestParameters: GetSbomComponentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>> {
         if (requestParameters.applicationId === null || requestParameters.applicationId === undefined) {
-            throw new runtime.RequiredError('applicationId','Required parameter requestParameters.applicationId was null or undefined when calling getListOfSbomsForApplicationId.');
-        }
-
-        const queryParameters: any = {};
-
-        if (requestParameters.sortByDate !== undefined) {
-            queryParameters['sortByDate'] = requestParameters.sortByDate;
+            throw new runtime.RequiredError('applicationId','Required parameter requestParameters.applicationId was null or undefined when calling getSbomComponents.');
         }
 
-        if (requestParameters.pageSize !== undefined) {
-            queryParameters['pageSize'] = requestParameters.pageSize;
+        if (requestParameters.version === null || requestParameters.version === undefined) {
+            throw new runtime.RequiredError('version','Required parameter requestParameters.version was null or undefined when calling getSbomComponents.');
         }
 
-        if (requestParameters.page !== undefined) {
-            queryParameters['page'] = requestParameters.page;
-        }
+        const queryParameters: any = {};
 
         const headerParameters: runtime.HTTPHeaders = {};
 
@@ -299,7 +333,7 @@ export class SbomApi extends runtime.BaseAPI implements SbomApiInterface {
             headerParameters["Authorization"] = "Basic " + btoa(this.configuration.username + ":" + this.configuration.password);
         }
         const response = await this.request({
-            path: `/api/v2/sbom/application/{applicationId}`.replace(`{${"applicationId"}}`, encodeURIComponent(String(requestParameters.applicationId))),
+            path: `/api/v2/sbom/applications/{applicationId}/versions/{version}/components`.replace(`{${"applicationId"}}`, encodeURIComponent(String(requestParameters.applicationId))).replace(`{${"version"}}`, encodeURIComponent(String(requestParameters.version))),
             method: 'GET',
             headers: headerParameters,
             query: queryParameters,
@@ -309,27 +343,35 @@ export class SbomApi extends runtime.BaseAPI implements SbomApiInterface {
     }
 
     /**
-     * Gets a paginated list of SBOMs for an application
-     * Gets a paginated list of SBOMs for an application
+     * Lists the components in a specific sbom version with data about vulnerabilities and licenses
+     * Gets the components found in a specific sbom version
      */
-    async getListOfSbomsForApplicationId(requestParameters: GetListOfSbomsForApplicationIdRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void> {
-        await this.getListOfSbomsForApplicationIdRaw(requestParameters, initOverrides);
+    async getSbomComponents(requestParameters: GetSbomComponentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void> {
+        await this.getSbomComponentsRaw(requestParameters, initOverrides);
     }
 
     /**
-     * Lists the components in a specific sbom version with data about vulnerabilities and licenses
-     * Gets the components found in a specific sbom version
+     * Gets a paginated list of SBOMs for an application
+     * Gets a paginated list of SBOMs for an application
      */
-    async getSbomComponentsRaw(requestParameters: GetSbomComponentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>> {
+    async getSbomMetadataSummaryForApplicationRaw(requestParameters: GetSbomMetadataSummaryForApplicationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>> {
         if (requestParameters.applicationId === null || requestParameters.applicationId === undefined) {
-            throw new runtime.RequiredError('applicationId','Required parameter requestParameters.applicationId was null or undefined when calling getSbomComponents.');
+            throw new runtime.RequiredError('applicationId','Required parameter requestParameters.applicationId was null or undefined when calling getSbomMetadataSummaryForApplication.');
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters.sortByDate !== undefined) {
+            queryParameters['sortByDate'] = requestParameters.sortByDate;
         }
 
-        if (requestParameters.sbomVersion === null || requestParameters.sbomVersion === undefined) {
-            throw new runtime.RequiredError('sbomVersion','Required parameter requestParameters.sbomVersion was null or undefined when calling getSbomComponents.');
+        if (requestParameters.pageSize !== undefined) {
+            queryParameters['pageSize'] = requestParameters.pageSize;
         }
 
-        const queryParameters: any = {};
+        if (requestParameters.page !== undefined) {
+            queryParameters['page'] = requestParameters.page;
+        }
 
         const headerParameters: runtime.HTTPHeaders = {};
 
@@ -337,7 +379,7 @@ export class SbomApi extends runtime.BaseAPI implements SbomApiInterface {
             headerParameters["Authorization"] = "Basic " + btoa(this.configuration.username + ":" + this.configuration.password);
         }
         const response = await this.request({
-            path: `/api/v2/sbom/{applicationId}/version/{sbomVersion}/components`.replace(`{${"applicationId"}}`, encodeURIComponent(String(requestParameters.applicationId))).replace(`{${"sbomVersion"}}`, encodeURIComponent(String(requestParameters.sbomVersion))),
+            path: `/api/v2/sbom/applications/{applicationId}`.replace(`{${"applicationId"}}`, encodeURIComponent(String(requestParameters.applicationId))),
             method: 'GET',
             headers: headerParameters,
             query: queryParameters,
@@ -347,11 +389,11 @@ export class SbomApi extends runtime.BaseAPI implements SbomApiInterface {
     }
 
     /**
-     * Lists the components in a specific sbom version with data about vulnerabilities and licenses
-     * Gets the components found in a specific sbom version
+     * Gets a paginated list of SBOMs for an application
+     * Gets a paginated list of SBOMs for an application
      */
-    async getSbomComponents(requestParameters: GetSbomComponentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void> {
-        await this.getSbomComponentsRaw(requestParameters, initOverrides);
+    async getSbomMetadataSummaryForApplication(requestParameters: GetSbomMetadataSummaryForApplicationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void> {
+        await this.getSbomMetadataSummaryForApplicationRaw(requestParameters, initOverrides);
     }
 
     /**
@@ -363,8 +405,8 @@ export class SbomApi extends runtime.BaseAPI implements SbomApiInterface {
             throw new runtime.RequiredError('applicationId','Required parameter requestParameters.applicationId was null or undefined when calling getSbomVersion.');
         }
 
-        if (requestParameters.sbomVersion === null || requestParameters.sbomVersion === undefined) {
-            throw new runtime.RequiredError('sbomVersion','Required parameter requestParameters.sbomVersion was null or undefined when calling getSbomVersion.');
+        if (requestParameters.version === null || requestParameters.version === undefined) {
+            throw new runtime.RequiredError('version','Required parameter requestParameters.version was null or undefined when calling getSbomVersion.');
         }
 
         const queryParameters: any = {};
@@ -383,7 +425,7 @@ export class SbomApi extends runtime.BaseAPI implements SbomApiInterface {
             headerParameters["Authorization"] = "Basic " + btoa(this.configuration.username + ":" + this.configuration.password);
         }
         const response = await this.request({
-            path: `/api/v2/sbom/{applicationId}/version/{sbomVersion}`.replace(`{${"applicationId"}}`, encodeURIComponent(String(requestParameters.applicationId))).replace(`{${"sbomVersion"}}`, encodeURIComponent(String(requestParameters.sbomVersion))),
+            path: `/api/v2/sbom/applications/{applicationId}/versions/{version}`.replace(`{${"applicationId"}}`, encodeURIComponent(String(requestParameters.applicationId))).replace(`{${"version"}}`, encodeURIComponent(String(requestParameters.version))),
             method: 'GET',
             headers: headerParameters,
             query: queryParameters,
@@ -417,7 +459,7 @@ export class SbomApi extends runtime.BaseAPI implements SbomApiInterface {
             headerParameters["Authorization"] = "Basic " + btoa(this.configuration.username + ":" + this.configuration.password);
         }
         const response = await this.request({
-            path: `/api/v2/sbom/sbomVersions/{applicationId}`.replace(`{${"applicationId"}}`, encodeURIComponent(String(requestParameters.applicationId))),
+            path: `/api/v2/sbom/applications/{applicationId}/versions`.replace(`{${"applicationId"}}`, encodeURIComponent(String(requestParameters.applicationId))),
             method: 'GET',
             headers: headerParameters,
             query: queryParameters,

package/src/apis/SbomDashboardApi.ts

@@ -0,0 +1,77 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Sonatype Lifecycle Public REST API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.176.0-01
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+import * as runtime from '../runtime';
+
+/**
+ * SbomDashboardApi - interface
+ * 
+ * @export
+ * @interface SbomDashboardApiInterface
+ */
+export interface SbomDashboardApiInterface {
+    /**
+     * Queries how many SBOMs have been analyzed and the threshold in the product license
+     * @summary Gets total of SBOMs analyzed and the threshold in the product license
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof SbomDashboardApiInterface
+     */
+    getSbomsAnalyzedMetricsRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+
+    /**
+     * Queries how many SBOMs have been analyzed and the threshold in the product license
+     * Gets total of SBOMs analyzed and the threshold in the product license
+     */
+    getSbomsAnalyzedMetrics(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+
+}
+
+/**
+ * 
+ */
+export class SbomDashboardApi extends runtime.BaseAPI implements SbomDashboardApiInterface {
+
+    /**
+     * Queries how many SBOMs have been analyzed and the threshold in the product license
+     * Gets total of SBOMs analyzed and the threshold in the product license
+     */
+    async getSbomsAnalyzedMetricsRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>> {
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && (this.configuration.username !== undefined || this.configuration.password !== undefined)) {
+            headerParameters["Authorization"] = "Basic " + btoa(this.configuration.username + ":" + this.configuration.password);
+        }
+        const response = await this.request({
+            path: `/api/v2/sbom/dashboard/sbomsAnalyzed`,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.VoidApiResponse(response);
+    }
+
+    /**
+     * Queries how many SBOMs have been analyzed and the threshold in the product license
+     * Gets total of SBOMs analyzed and the threshold in the product license
+     */
+    async getSbomsAnalyzedMetrics(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void> {
+        await this.getSbomsAnalyzedMetricsRaw(initOverrides);
+    }
+
+}

package/src/apis/ScanApi.ts

@@ -4,7 +4,7 @@
  * Sonatype Lifecycle Public REST API
  * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
  *
- * The version of the OpenAPI document: 1.175.0-01
+ * The version of the OpenAPI document: 1.176.0-01
  * 
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).