From dd997b6ac7738822a52f6ccd94d133dfeb8a82ec Mon Sep 17 00:00:00 2001 From: provokateurin Date: Mon, 13 May 2024 12:47:24 +0200 Subject: docs(preview): Improve API parameter descriptions Signed-off-by: provokateurin --- core/openapi.json | 24 ++++++++++++++++-------- 1 file changed, 16 insertions(+), 8 deletions(-) (limited to 'core/openapi.json') diff --git a/core/openapi.json b/core/openapi.json index 37c32cb7404..1c7b2caeeac 100644 --- a/core/openapi.json +++ b/core/openapi.json @@ -6212,7 +6212,7 @@ { "name": "x", "in": "query", - "description": "Width of the preview", + "description": "Width of the preview. A width of -1 will use the original image width.", "schema": { "type": "integer", "format": "int64", @@ -6222,7 +6222,7 @@ { "name": "y", "in": "query", - "description": "Height of the preview", + "description": "Height of the preview. A height of -1 will use the original image height.", "schema": { "type": "integer", "format": "int64", @@ -6232,7 +6232,7 @@ { "name": "a", "in": "query", - "description": "Whether to not crop the preview", + "description": "Preserve the aspect ratio", "schema": { "type": "integer", "default": 0, @@ -6261,7 +6261,11 @@ "description": "How to crop the image", "schema": { "type": "string", - "default": "fill" + "default": "fill", + "enum": [ + "fill", + "cover" + ] } }, { @@ -6356,7 +6360,7 @@ { "name": "x", "in": "query", - "description": "Width of the preview", + "description": "Width of the preview. A width of -1 will use the original image width.", "schema": { "type": "integer", "format": "int64", @@ -6366,7 +6370,7 @@ { "name": "y", "in": "query", - "description": "Height of the preview", + "description": "Height of the preview. A height of -1 will use the original image height.", "schema": { "type": "integer", "format": "int64", @@ -6376,7 +6380,7 @@ { "name": "a", "in": "query", - "description": "Whether to not crop the preview", + "description": "Preserve the aspect ratio", "schema": { "type": "integer", "default": 0, @@ -6405,7 +6409,11 @@ "description": "How to crop the image", "schema": { "type": "string", - "default": "fill" + "default": "fill", + "enum": [ + "fill", + "cover" + ] } }, { -- cgit v1.2.3