Enum WebhookError 

#[non_exhaustive]
pub enum WebhookError {
    InvalidSignature,
    MissingSignature {
        header: String,
    },
    TimestampExpired {
        age_seconds: u64,
        max_seconds: u64,
    },
    TimestampFuture {
        future_seconds: u64,
    },
    DuplicateEvent {
        event_id: String,
    },
    UnknownEvent {
        event_type: String,
    },
    ProviderNotConfigured {
        provider: String,
    },
    PayloadError {
        message: String,
    },
    IdempotencyError {
        message: String,
    },
}

Errors that occur while receiving and validating inbound webhook requests.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

InvalidSignature

The HMAC signature on the webhook payload does not match the expected value for the shared secret.

This can indicate an invalid secret, payload tampering, or a replay from a different provider.

MissingSignature

The expected signature header was absent from the incoming request.

Fields

header: String

Name of the HTTP header that was expected but not present.

TimestampExpired

The webhook timestamp is older than the configured replay-window, indicating a replay attack or severe clock skew.

Fields

age_seconds: u64

Age of the webhook event in seconds.

max_seconds: u64

Maximum allowed age in seconds.

TimestampFuture

The webhook timestamp is further in the future than clock skew allows, suggesting a pre-generated or tampered request.

Fields

future_seconds: u64

Number of seconds the timestamp is ahead of the server clock.

DuplicateEvent

An event with this identifier has already been successfully processed.

The event should be acknowledged (2xx) and then discarded.

Fields

event_id: String

Identifier of the duplicate event.

UnknownEvent

The event’s type field does not correspond to any registered handler.

Fields

event_type: String

The unrecognised event type string.

ProviderNotConfigured

A webhook was received from a provider that has not been configured in fraiseql.toml.

Fields

provider: String

Name of the unconfigured provider.

PayloadError

The webhook request body could not be parsed (invalid JSON, unexpected schema, etc.).

The raw error message is kept server-side and a generic response is returned to the caller.

Fields

message: String

Description of the parse failure (server-side only).

IdempotencyError

The idempotency check (deduplication store lookup or write) failed.

Fields

message: String

Description of the idempotency failure.

Implementations

impl WebhookError

pub const fn error_code(&self) -> &'static str

Returns a short, stable error code string suitable for API responses and structured logging.

Trait Implementations

impl Debug for WebhookError

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

Formats the value using the given formatter.

impl Display for WebhookError

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

Formats the value using the given formatter.

impl Error for WebhookError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<WebhookError> for RuntimeError

fn from(source: WebhookError) -> Self

Converts to this type from the input type.