utoipa
utoipa copied to clipboard
Simple, Fast, Code first and Compile time generated OpenAPI documentation for Rust
OpenAPI v3.1 supports the ability to configure an object schema with `propertyNames` that can restrict the property keys allowed for an object. A common case is where an `enum` schema...
Hello, I wanted to raise a note that this crate currently has a transitive dependency on `option-ext`. That library is MPL-2, a copyleft license. The `option-ext` dependency is brought in...
## Background 1. Take the `todo-axum` crate 2. add a generic enum type with an alias, as recommended in docs: #[derive(ToSchema, Serialize, Deserialize, Clone)] #[aliases(TestEnumString = TestEnum)] pub(super) enum TestEnum...
I have a struct `Object` ```rs #[cfg_attr(feature = "openapi", derive(utoipa::ToSchema))] #[derive(Debug, Clone, Serialize, Deserialize)] pub struct Object { #[cfg_attr(feature = "openapi", schema(format = Uuid))] pub id: Uuid, #[cfg_attr(feature = "openapi",...
The cookie is not carried in the request header. I'm not sure if it has anything to do with [When using cookie authentication use document.cookie](https://github.com/swagger-api/swagger-ui/issues/8683) This is the `Cargo.toml` file...
I have an endpoint (/health) that accepts GET,HEAD,OPTIONS, this compiles but only uses the last one (HEAD): ```rust #[utoipa::path( get, path= "/health", responses ( (status = 200, description = "Database...
Is it possible to change `In` of OIDC token from `Authorization` header to a custom cookie?, I only see api key auth in the documentation that supports cookie, wondering if...
Assuming I have some struct: ```rust pub struct SearchResult {}; ``` Which I use throughout different APIs. that makes it impossible to use the `#[alias]`, as it doesn't know anything...
When using `ToSchema` with a unit struct, it generates a call to `utoipa::openapi::schema::empty()` without including the summary or description. This can be bypassed by using `{ }`, but this has...
The Header struct misses the fields inherited from Parameter struct. For example, "required", "deprecated", "style", "explode", "examples", "example", "content" and "extensions". Please verify the resources you supplied. [ https://spec.openapis.org/oas/latest.html#header-object](https://spec.openapis.org/oas/latest.html#header-object) It...