[oapi] tags

[josejachuf]

Using utoipa I defined the ApiDoc structure in this way

#[derive(OpenApi)]
#[openapi(
    paths(
        health::get_health,
        foo::get_bar1,
        foo::get_bar2,
    ),
    components(
        schemas(
            health::Health,
            foo::Bar,           
        )
    ),
    tags(
        (name = "health", description = "Health status."),
        (name = "foo", description = "description for foo endpoints"),        
    )
)]
struct ApiDoc;

  "tags": [
    {
      "name": "health",
      "description": "Health status."
    },
    {
      "name": "foo",
      "description": "description for foo endpoints"
    },
  ]

This is created in the openapi.json file the tags, which when you see them in HTML with Swagger I get the grouped endpoints

Instead with salvo oapi I get "default"

I saw that tags can be defined here, but I don't know how to use it

let doc = OpenApi::new("TEST API", "0.1.1")
        .merge_router(&router);

Best regards!

[chrislearn]

Try this:

#[endpoint(tags("health"))]

[josejachuf]

to this:

tags(
        (name = "health", description = "Health status."),
        (name = "foo", description = "description for foo endpoints"),        
    )

[chrislearn]

https://docs.rs/salvo-oapi/latest/salvo_oapi/struct.OpenApi.html#method.tags

Just call OpenApi::tags function.

[josejachuf]

I tried here, but I don't know how to define the tags like a tuplas

let doc = OpenApi::new("TEST API", "0.1.1")
    .tags()
    .merge_router(&router);

something similar to:

tags(
        (name = "health", description = "Health status."),
        (name = "foo", description = "description for foo endpoints"),        
    )

I get error

[chrislearn]

let doc = OpenApi::new("TEST API", "0.1.1")
    .tags([Tag::new("health").description("Health status."), Tag::new("foo").description("description for foo endpoints")])
    .merge_router(&router);

[josejachuf]

This works fine.
Thanks vey much!