1
0
mirror of https://github.com/Unleash/unleash.git synced 2025-08-18 13:48:58 +02:00

OpenAPI tags

This commit is contained in:
Gastón Fournier 2023-01-26 10:16:38 +01:00
parent ee0d3f7f6f
commit 9a1011cc8b
No known key found for this signature in database
GPG Key ID: BC3E6CD5E81633B8
3 changed files with 21 additions and 6 deletions

View File

@ -13,6 +13,11 @@ const OPENAPI_TAGS = [
description:
'Create, update, and delete [Unleash API tokens](https://docs.getunleash.io/reference/api-tokens-and-client-keys).',
},
{
name: 'Personal access tokens',
description:
'Create, update, and delete [Personal access tokens](https://docs.getunleash.io/reference/api-tokens-and-client-keys#personal-access-tokens).',
},
{
name: 'Archive',
description:
@ -96,10 +101,20 @@ const OPENAPI_TAGS = [
'Experimental endpoints that may change or disappear at any time.',
},
{ name: 'Edge', description: 'Endpoints related to Unleash on the Edge.' },
{
name: 'Frontend API',
description:
'API for connecting client-side (frontend) applications to Unleash.',
},
{
name: 'Maintenance',
description: 'Enable/disable the maintenance mode of Unleash.',
},
{
name: 'Change Requests',
description:
'API for managing [change requests](https://docs.getunleash.io/reference/change-requests).',
},
] as const;
// make the export mutable, so it can be used in a schema

View File

@ -39,7 +39,7 @@ export default class PatController extends Controller {
permission: NONE,
middleware: [
openApiService.validPath({
tags: ['API tokens'],
tags: ['Personal access tokens'],
operationId: 'getPats',
responses: { 200: createResponseSchema('patsSchema') },
}),
@ -52,7 +52,7 @@ export default class PatController extends Controller {
permission: NONE,
middleware: [
openApiService.validPath({
tags: ['API tokens'],
tags: ['Personal access tokens'],
operationId: 'createPat',
requestBody: createRequestSchema('patSchema'),
responses: { 200: createResponseSchema('patSchema') },
@ -68,7 +68,7 @@ export default class PatController extends Controller {
permission: NONE,
middleware: [
openApiService.validPath({
tags: ['API tokens'],
tags: ['Personal access tokens'],
operationId: 'deletePat',
responses: { 200: emptyResponse },
}),

View File

@ -63,7 +63,7 @@ export default class ProxyController extends Controller {
permission: NONE,
middleware: [
this.services.openApiService.validPath({
tags: ['Unstable'],
tags: ['Frontend API'],
operationId: 'getFrontendFeatures',
responses: {
200: createResponseSchema('proxyFeaturesSchema'),
@ -93,7 +93,7 @@ export default class ProxyController extends Controller {
permission: NONE,
middleware: [
this.services.openApiService.validPath({
tags: ['Unstable'],
tags: ['Frontend API'],
operationId: 'registerFrontendMetrics',
requestBody: createRequestSchema('proxyMetricsSchema'),
responses: { 200: emptyResponse },
@ -108,7 +108,7 @@ export default class ProxyController extends Controller {
permission: NONE,
middleware: [
this.services.openApiService.validPath({
tags: ['Unstable'],
tags: ['Frontend API'],
operationId: 'registerFrontendClient',
requestBody: createRequestSchema('proxyClientSchema'),
responses: { 200: emptyResponse },