Openapi default value for simple query parameter

[rsJames-ttrpg]

I have a paginated endpoint and want the documentation to say the default values for the query params I think I might be missing something simple:

    #[oai(
        path = "/stuff",
        method = "get",
        tag = super::ApiTags::Stuff,
        operation_id = "list-stuff"
    )]
    async fn list_stuff(
        &self,
        #[oai(default)] page: Query<Option<i64>>,
        #[oai(default)] per_page: Query<Option<i64>>
    ) -> ListStuffResponse {
        let page: i64 = page.0.unwrap_or(1);
        let per_page = per_page.0.unwrap_or(10);
        ...
    }

I have to do the unwrap_or and the information is not documented but the functionality works.

The approaches I have tried wrapping i64 and implementing default trait. Then I need to write my own api adapter traits etc. It seems like I am missing something simple here.

[danechitoaie]

See here: https://github.com/poem-web/poem/blob/master/poem-openapi/src/docs/openapi.md#operation-argument-parameters

default can be bool or string. If it's string you can pass the name of a function that returns the default value that should be used.

For some reason this still does not appear in Swagger UI, but in the generated JSON/YAML spec it does.