From c4ddfef2ed329b9a98772f730a2605e014ef21ba Mon Sep 17 00:00:00 2001 From: syuilo Date: Mon, 25 Feb 2019 09:37:22 +0900 Subject: [PATCH] Improve doc --- src/server/api/openapi/gen-spec.ts | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/src/server/api/openapi/gen-spec.ts b/src/server/api/openapi/gen-spec.ts index 64da6edbeb..915fb5a6a3 100644 --- a/src/server/api/openapi/gen-spec.ts +++ b/src/server/api/openapi/gen-spec.ts @@ -108,10 +108,14 @@ export function genOpenapiSpec(lang = 'ja-JP') { const resSchema = endpoint.meta.res ? convertOpenApiSchema(endpoint.meta.res) : {}; + let desc = (endpoint.meta.desc ? endpoint.meta.desc[lang] : 'No description provided.') + '\n\n'; + desc += `**Credential required**: *${endpoint.meta.requireCredential ? 'Yes' : 'No'}*`; + if (endpoint.meta.kind) desc += ` / **Permission**: *${endpoint.meta.kind}*`; + const info = { operationId: endpoint.name, summary: endpoint.name, - description: endpoint.meta.desc ? endpoint.meta.desc[lang] : 'No description provided.', + description: desc, externalDocs: { description: 'Source code', url: `https://github.com/syuilo/misskey/blob/develop/src/server/api/endpoints/${endpoint.name}.ts`