Struct RequestError 

pub struct RequestError { /* private fields */ }

OAuth request error for token operations and auth flows

Implementations

impl RequestError

pub fn new(kind: RequestErrorKind, source: Option<BoxError>) -> Self

Create a new error with the given kind and optional source

pub fn kind(&self) -> &RequestErrorKind

Get the error kind

pub fn source_err(&self) -> Option<&BoxError>

Get the source error if present

pub fn context(&self) -> Option<&str>

Get the context string if present

pub fn url(&self) -> Option<&str>

Get the URL if present

pub fn details(&self) -> Option<&str>

Get the details if present

pub fn location(&self) -> Option<&str>

Get the location if present

pub fn with_help(self, help: impl Into<SmolStr>) -> Self

Add help text to this error

pub fn with_context(self, context: impl Into<SmolStr>) -> Self

Add context to this error

pub fn with_url(self, url: impl Into<SmolStr>) -> Self

Add URL to this error

pub fn with_details(self, details: impl Into<SmolStr>) -> Self

Add details to this error

pub fn with_location(self, location: impl Into<SmolStr>) -> Self

Add location to this error

pub fn no_endpoint(endpoint: impl Into<SmolStr>) -> Self

Create a no endpoint error

pub fn token_verification() -> Self

Create a token verification error

pub fn unsupported_auth_method() -> Self

Create an unsupported authentication method error

pub fn no_refresh_token() -> Self

Create a no refresh token error

pub fn invalid_did(source: impl Error + Send + Sync + 'static) -> Self

Create an invalid DID error

pub fn dpop(source: impl Error + Send + Sync + 'static) -> Self

Create a DPoP error

pub fn storage(source: impl Error + Send + Sync + 'static) -> Self

Create a storage error

pub fn resolver(source: impl Error + Send + Sync + 'static) -> Self

Create a resolver error

pub fn http_build(source: impl Error + Send + Sync + 'static) -> Self

Create an HTTP build error

pub fn http_status(status: StatusCode) -> Self

Create an HTTP status error

pub fn http_status_with_body(status: StatusCode, body: Value) -> Self

Create an HTTP status with body error

pub fn identity(source: impl Error + Send + Sync + 'static) -> Self

Create an identity error

pub fn keyset(source: impl Error + Send + Sync + 'static) -> Self

Create a keyset error

pub fn atproto(source: impl Error + Send + Sync + 'static) -> Self

Create an atproto metadata error

pub fn par_required() -> Self

Create an error for atproto metadata that does not advertise required PAR support.

pub fn is_permanent(&self) -> bool

Returns true if this error indicates permanent auth failure (token revoked, refresh_token expired, etc.)

When this returns true, the session should be cleared from storage rather than retried.

Trait Implementations

impl Debug for RequestError

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

Formats the value using the given formatter.

impl Diagnostic for RequestError

fn help(&self) -> Option<Box<dyn Display + '_>>

Additional help text related to this Diagnostic. Do you have any advice for the poor soul who’s just run into this issue?

fn diagnostic_source<'a>(&'a self) -> Option<&'a dyn Diagnostic>

The cause of the error.

fn code<'a>(&'a self) -> Option<Box<dyn Display + 'a>>

Unique diagnostic code that can be used to look up more information about this Diagnostic. Ideally also globally unique, and documented in the toplevel crate’s documentation for easy searching. Rust path format (foo::bar::baz) is recommended, but more classic codes like E0123 or enums will work just fine.

fn severity(&self) -> Option<Severity>

Diagnostic severity. This may be used by ReportHandlers to change the display format of this diagnostic.

fn url<'a>(&'a self) -> Option<Box<dyn Display + 'a>>

URL to visit for a more detailed explanation/help about this Diagnostic.

fn source_code(&self) -> Option<&dyn SourceCode>

Source code to apply this Diagnostic’s Diagnostic::labels to.

fn labels(&self) -> Option<Box<dyn Iterator<Item = LabeledSpan> + '_>>

Labels to apply to this Diagnostic’s Diagnostic::source_code

fn related<'a>( &'a self, ) -> Option<Box<dyn Iterator<Item = &'a dyn Diagnostic> + 'a>>

Additional related Diagnostics.

impl Display for RequestError

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

Formats the value using the given formatter.

impl Error for RequestError

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<AtStrError> for RequestError

fn from(e: AtStrError) -> Self

Converts to this type from the input type.

impl From<DpopError> for RequestError

fn from(e: DpopError) -> Self

Converts to this type from the input type.

impl From<Error> for RequestError

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<Error> for RequestError

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<Error> for RequestError

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<Error> for RequestError

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<Error> for RequestError

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<IdentityError> for RequestError

fn from(e: IdentityError) -> Self

Converts to this type from the input type.

impl From<RequestError> for OAuthError

fn from(source: RequestError) -> Self

Converts to this type from the input type.

impl From<RequestError> for Error

fn from(source: RequestError) -> Self

Converts to this type from the input type.

impl From<ResolverError> for RequestError

fn from(e: ResolverError) -> Self

Converts to this type from the input type.

impl From<SessionStoreError> for RequestError

fn from(e: SessionStoreError) -> Self

Converts to this type from the input type.