Enum ApiError 

pub enum ApiError {
    NotFound(String),
    Conflict(String),
    BadRequest(String),
    Forbidden(String),
    TooManyRequests {
        message: String,
        retry_after_secs: u64,
    },
    GlobalCapacity {
        message: String,
        retry_after_secs: u64,
    },
    Unauthorized(String),
    Internal(Error),
}

Every way a request can fail, already carrying the HTTP status it maps to – handlers return Result<_, ApiError> and let ? do the conversion (see the From impls below), the same “one error enum, converted at the boundary” shape bhtune-cli’s commands use with anyhow::Result.

Variants

NotFound(String)

The requested resource doesn’t exist (a template name, a run id). 404.

Conflict(String)

The request conflicts with existing state (a name collision on create, a delete blocked by a foreign-key reference). 409.

BadRequest(String)

The request body/query itself is malformed or fails domain validation (DcsTemplate::validate, an unparseable filter value axum’s extractors didn’t already reject). 400.

Forbidden(String)

The request was authenticated but is not permitted. 403.

TooManyRequests

A per-client or per-session limit was exceeded. 429, with a Retry-After header.

Fields

message: String

retry_after_secs: u64

GlobalCapacity

The public demo has exhausted a global capacity limit. 503, with a Retry-After header. Keeping this distinct from per-client throttling lets callers avoid telling a client that its own request rate caused shared service saturation.

Fields

message: String

retry_after_secs: u64

Unauthorized(String)

No valid demo identity was supplied. 401.

Internal(Error)

Anything else: a database connection/query failure, or any other unexpected error. Deliberately doesn’t echo the underlying error’s Display text into the response body (logged via tracing::error! instead) – an internal error’s detail is for the server’s own logs, not a client that can’t act on it. 500.

Trait Implementations

impl Debug for ApiError

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

Formats the value using the given formatter.

impl From<DbError> for ApiError

fn from(err: DbError) -> Self

bhtune_db::DbError::TemplateInUse is the one variant a client can actually act on (stop trying to delete a template still referenced by a saved loop) – everything else is an infrastructure-level failure the client can’t distinguish or fix, so it collapses to ApiError::Internal.

impl From<Error> for ApiError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl IntoResponse for ApiError

fn into_response(self) -> Response

Create a response.