improve the description of all the settings route

This commit is contained in:
Tamo 2025-01-06 11:54:39 +01:00
parent 28162759a4
commit 8b95c6ae56
No known key found for this signature in database
GPG Key ID: 20CD8020AFA88D69

View File

@ -81,12 +81,13 @@ macro_rules! make_setting_route {
#[allow(unused_imports)]
use super::*;
#[doc = $camelcase_attr]
#[utoipa::path(
delete,
path = concat!("{indexUid}/settings", $route),
tag = "Settings",
security(("Bearer" = ["settings.update", "settings.*", "*"])),
summary = concat!("Reset ", $camelcase_attr),
description = concat!("Reset an index's ", $camelcase_attr, " to its default value"),
params(("indexUid", example = "movies", description = "Index Unique Identifier", nullable = false)),
request_body = $type,
responses(
@ -149,6 +150,8 @@ macro_rules! make_setting_route {
path = concat!("{indexUid}/settings", $route),
tag = "Settings",
security(("Bearer" = ["settings.update", "settings.*", "*"])),
summary = concat!("Update ", $camelcase_attr),
description = concat!("Update an index's user defined ", $camelcase_attr),
params(("indexUid", example = "movies", description = "Index Unique Identifier", nullable = false)),
request_body = $type,
responses(
@ -232,6 +235,8 @@ macro_rules! make_setting_route {
get,
path = concat!("{indexUid}/settings", $route),
tag = "Settings",
summary = concat!("Get ", $camelcase_attr),
description = concat!("Get an user defined ", $camelcase_attr),
security(("Bearer" = ["settings.get", "settings.*", "*"])),
params(("indexUid", example = "movies", description = "Index Unique Identifier", nullable = false)),
responses(