Enum Error 

pub enum Error {
    Api {
        error_code: u16,
        description: String,
        migrate_to_chat_id: Option<i64>,
        retry_after: Option<u32>,
    },
    Http(Error),
    Serialization(Error),
    Decode(String),
    RateLimit {
        retry_after: u32,
    },
    InvalidToken,
    MissingParam(&'static str),
}

Errors that can occur when interacting with the Telegram Bot API.

Variants

Api

The Telegram API returned ok: false.

Fields

error_code: u16

The HTTP error code returned by Telegram.

description: String

Human-readable description of the error.

migrate_to_chat_id: Option<i64>

If set, the group was migrated to a supergroup with this ID.

retry_after: Option<u32>

If set, retry the request after this many seconds.

Http(Error)

HTTP transport or network error.

Serialization(Error)

Failed to serialise the request body.

Decode(String)

The response body could not be decoded.

RateLimit

Rate limit hit — caller should wait retry_after seconds before retrying.

Fields

retry_after: u32

Number of seconds to wait before retrying.

InvalidToken

The provided token format is invalid.

MissingParam(&'static str)

A required parameter was missing.

Implementations

impl Error

pub fn is_rate_limit(&self) -> bool

Returns true if this is a flood-control error (429).

pub fn retry_after(&self) -> Option<u32>

Extracts the retry_after value if available.

pub fn is_blocked(&self) -> bool

Returns true if the bot is blocked by the user.

pub fn is_chat_not_found(&self) -> bool

Returns true if the chat was not found.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.