Struct ApiServer 

pub struct ApiServer { /* private fields */ }

The Zart API server.

Wraps an Axum router and exposes durable execution management over HTTP.

Implementations

impl ApiServer

pub fn new(addr: impl Into<String>, durable: Arc<dyn DurableApi>) -> Self

Create a new API server bound to addr.

pub fn with_cancellation( addr: impl Into<String>, durable: Arc<dyn DurableApi>, cancellation: CancellationToken, ) -> Self

Create a new API server with a cancellation token for graceful shutdown.

pub fn with_api_prefix(self, prefix: impl Into<String>) -> Self

Override the main API route prefix (default: "/api/v1").

Takes precedence over the ZART_API_PREFIX environment variable.

pub fn with_admin_prefix(self, prefix: impl Into<String>) -> Self

Override the admin API route prefix (default: "/zart/admin/v1").

Takes precedence over the ZART_ADMIN_PREFIX environment variable.

pub fn router(&self) -> Router

Build the Axum router with main API routes and middleware.

Health checks (/healthz, /readyz) and metrics (/metrics) are always mounted at the root, unaffected by Self::with_api_prefix.

The admin router is not included; mount it separately via crate::admin_routes::admin_router passing the admin_prefix configured via Self::with_admin_prefix.

pub async fn serve(self) -> Result<(), Error>

Start listening and serving requests.

Blocks until the server is shut down.