Struct HttpApi 

pub struct HttpApi<H> { /* private fields */ }

HTTP API service builder.

Also

• ApiHandler the trait backing all endpoints.
• ApiError mapped to JSON + HTTP status codes.

Implementations

impl<H> HttpApi<H>

where H: ApiHandler,

pub fn new(handler: Arc<H>) -> Self

Create new HTTP API with the given handler.

pub fn with_auth(self, token: Token) -> Self

Require a bearer token on every request.

When set, requests without a valid Authorization: Bearer <token> header are rejected with 401 Unauthorized before reaching any handler . This is the same shared secret the agent presents to the control plane in discovery, one config value enables both directions. Orthogonal to TLS. When unset, no auth is enforced.

pub fn router(self) -> Router

Build axum router with mounted endpoints.

Applies a RequestBodyLimitLayer capped at MAX_REQUEST_BYTES bytes to every request, and when with_auth is set a bearer-token gate that runs before any handler.