Module core 

Stable core surface exposed by the facade.

Macros

route

Helper macro to create a Route from a handler with RouteHandler trait

Structs

ApiError

Standard API error type

AsyncValidatedJson

Async validated JSON body extractor

Body

Raw body bytes extractor

BodyLimitLayer

Body size limit middleware layer

BodyStream

Streaming body extractor

ClientIp

Client IP address extractor

Created

201 Created response wrapper

Extension

Extension extractor

FieldError

Field-level validation error

HandlerService

Wrapper to convert a Handler into a tower Service

HeaderValue

Single header value extractor

Headers

Headers extractor

Html

HTML response wrapper

Json

JSON body extractor

KeepAlive

Keep-alive configuration for SSE connections

MethodRouter

HTTP method router for a single path

Multipart

Multipart form data extractor

MultipartConfig

Configuration for multipart form handling

MultipartField

A single field from a multipart form

NoContent

204 No Content response

Path

Path parameter extractor

Query

Query string extractor

Redirect

Redirect response

Request

HTTP Request wrapper

RequestId

A unique identifier for a request

RequestIdLayer

Middleware layer that generates a unique request ID for each request

Route

Represents a route definition that can be registered with .mount()

Router

Main router

RustApi

Main application builder for RustAPI

RustApiConfig

Configuration builder for RustAPI with auto-routes

Sse

Server-Sent Events response wrapper

SseEvent

A Server-Sent Event

State

State extractor

StaticFile

Static file response

StaticFileConfig

Static file serving configuration

StatusCode

An HTTP status code (status-code in RFC 9110 et al.).

StreamBody

A streaming body wrapper for HTTP responses

TracingLayer

Middleware layer that creates tracing spans for requests

Typed

Typed path extractor

UploadedFile

File data wrapper for convenient access to uploaded files

ValidatedJson

Validated JSON body extractor

WithStatus

Generic wrapper for returning a response with a custom status code.

Enums

BodyVariant

Internal representation of the request body state

Environment

Environment configuration for error handling behavior

ResponseBody

Unified response body type

RouteMatch

Result of route matching

Traits

FromRequest

Trait for extracting data from the full request (including body)

FromRequestParts

Trait for extracting data from request parts (headers, path, query)

Handler

Trait representing an async handler function

IntoResponse

Trait for types that can be converted into an HTTP response

RouteHandler

Trait for handlers with route metadata (generated by #[rustapi::get], etc.)

TypedPath

Trait for defining typed paths

Validatable

Unified validation trait for synchronous validation

Functions

collect_auto_routes

Collect all auto-registered routes.

delete

Create a DELETE route handler

delete_route

Create a DELETE route

get

Create a GET route handler

get_environment

Get the current environment (cached)

get_route

Create a GET route

patch

Create a PATCH route handler

patch_route

Create a PATCH route

post

Create a POST route handler

post_route

Create a POST route

put

Create a PUT route handler

put_route

Create a PUT route

serve_dir

Create a static file serving route

sse_response

Create an SSE response from a synchronous iterator of events

Type Aliases

Response

HTTP Response type

Result

Result type alias for RustAPI operations