Is there any openapi::Content::new(Some(ResponseBody::schema())) equivalent for query?

[lamualfa]

The goal is to maintain the single source of truth. For response body, we can use struct as the schema. Is it possible to do so for query (.e.g. GetDoctorDetailsQuery)?

fn get_doctor_details_doc() -> openapi::PathItem {
    openapi::PathItem::builder()
        .operation(
            utoipa::openapi::HttpMethod::Get,
            openapi::path::Operation::builder()
                .response(
                    StatusCode::OK.as_u16().to_string(),
                    openapi::Response::builder().content(
                        "application/json",
                        openapi::Content::new(Some(GetDoctorDetailsResponse::schema())),
                    ),
                )
                .response(
                    StatusCode::INTERNAL_SERVER_ERROR.as_u16().to_string(),
                    openapi::Response::builder().content(
                        "application/json",
                        openapi::Content::new(Some(InternalServerError::schema())),
                    ),
                )
                .parameters(Some(vec![
                    openapi::path::Parameter::builder()
                        .name("before")
                        .description(Some(
                            "Cursor for pagination - return results before this doctor ID",
                        ))
                        .parameter_in(openapi::path::ParameterIn::Query)
                        .required(utoipa::openapi::Required::False)
                        .build(),
                    openapi::path::Parameter::builder()
                        .name("after")
                        .description(Some(
                            "Cursor for pagination - return results after this doctor ID",
                        ))
                        .parameter_in(openapi::path::ParameterIn::Query)
                        .required(utoipa::openapi::Required::False)
                        .build(),
                    openapi::path::Parameter::builder()
                        .name("limit")
                        .description(Some("Maximum number of results to return (default: 15)"))
                        .parameter_in(openapi::path::ParameterIn::Query)
                        .required(utoipa::openapi::Required::False)
                        .build(),
                ])),
        )
        .build()
}

#[derive(Deserialize, IntoParams)]
struct GetDoctorDetailsQuery {
    before: Option<String>,
    after: Option<String>,
    limit: Option<usize>,
}

#[derive(Serialize, ToSchema)]
struct GetDoctorDetailsResponse {
    next_cursor: Option<String>,
    rows: Vec<DoctorDetail>,
}

Use struct as schema for response body:

openapi::path::Operation::builder()
    .response(
        StatusCode::OK.as_u16().to_string(),
        openapi::Response::builder().content(
            "application/json",
            openapi::Content::new(Some(GetDoctorDetailsResponse::schema())),
        ),
    )

[lamualfa]

You can. But it's undocumented i think:

openapi::path::Operation::builder()
    .parameters(
        Some(
            GetDoctorDetailsQuery::into_params(|| {
                Some(ParameterIn::Query)
            })
        )
    )