Struct ApiDoc 

pub struct ApiDoc {

    pub method: &'static str,
    pub path: &'static str,
    pub operation_id: &'static str,
    pub summary: Option<&'static str>,
    pub description: Option<&'static str>,
    pub tags: &'static [&'static str],
    pub path_params: &'static [&'static str],
    pub request_body: Option<SchemaEntry>,
    pub response: Option<SchemaEntry>,
    pub success_status: u16,
    pub hidden: bool,
    pub query_schema: Option<SchemaEntry>,
    pub secured: bool,
    pub required_roles: &'static [&'static str],
    pub register_schemas: Option<fn(&mut SchemaRegistry)>,
}

OpenAPI metadata emitted alongside every annotated route.

Populated by the route macros (get, post, etc.) from the handler’s path, signature, and any #[api_doc(...)] overrides.

Fields

method: &'static str

HTTP method as an uppercase string (e.g. "GET").

path: &'static str

Raw route path with {param} placeholders (e.g. "/users/{id}").

operation_id: &'static str

Handler function name — used as the default operationId.

summary: Option<&'static str>

Short human-readable summary (from #[api_doc(summary = ...)]).

description: Option<&'static str>

Longer free-form description.

tags: &'static [&'static str]

Grouping tags. Defaults to the first path segment when unset.

path_params: &'static [&'static str]

Path parameter names extracted from the URL template.

Built at compile time from {...} segments in the route path.

request_body: Option<SchemaEntry>

Optional schema for the request body (typically the inner type of a Json<T> extractor).

response: Option<SchemaEntry>

Optional schema for the success response (typically the inner type of a Json<T> return value).

success_status: u16

Success HTTP status code, defaults to 200.

hidden: bool

When true, the route is excluded from the generated spec.

query_schema: Option<SchemaEntry>

Optional query-parameter schema inferred from Query<T> extractors.

secured: bool

True when the route requires authentication (#[secured]).

required_roles: &'static [&'static str]

Roles required by #[secured("role1")]. Empty means any authenticated user.

register_schemas: Option<fn(&mut SchemaRegistry)>

Optional runtime hook that lets a handler register any extra component schemas with the generator.

Trait Implementations

impl Clone for ApiDoc

fn clone(&self) -> ApiDoc

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ApiDoc

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ApiDoc

fn default() -> ApiDoc

Returns the “default value” for a type.