ErrorKind

Enum ErrorKind 

Source
#[non_exhaustive]
pub enum ErrorKind {
Show 22 variants Unrecognized, InvalidIdempotencyKey, ValidationError400, MissingApiKey, RestrictedApiKey, InvalidApiKey, ValidationError403, NotFound, MethodNotAllowed, InvalidIdempotentRequest, ConcurrentIdempotentRequests, InvalidAttachment, InvalidFromAddress, InvalidAccess, InvalidParameter, InvalidRegion, MissingRequiredField, DailyQuotaExceeded, RateLimitExceeded, SecurityError, ApplicationError, InternalServerError,
}
Expand description

Error type for operations of a Resend client.

https://resend.com/docs/api-reference/errors

Variants (Non-exhaustive)§

This enum is marked as 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.
§

Unrecognized

Error name is not in the API spec.

§

InvalidIdempotencyKey

400 Bad Request.

  • invalid_idempotency_key

The key must be between 1-256 chars.

Retry with a valid idempotency key.

§

ValidationError400

400 Bad Request.

  • validation_error

We found an error with one or more fields in the request.

The message will contain more details about what field and error were found.

§

MissingApiKey

401 Unauthorized.

  • missing_api_key

Missing API key in the authorization header.

Include the following header Authorization: Bearer YOUR_API_KEY in the request.

§

RestrictedApiKey

401 Unauthorized

  • restricted_api_key

This API key is restricted to only send emails.

Make sure the API key has Full access to perform actions other than sending emails.

§

InvalidApiKey

403 Forbidden.

  • invalid_api_key

API key is invalid.

Make sure the API key is correct or generate a new API key in the dashboard.

§

ValidationError403

403 Forbidden.

  • validation_error

You can only send testing emails to your own email address (youremail@domain.com).

In Resend’s Domain page, add and verify a domain for which you have DNS access. This allows you to send emails to addresses beyond your own.

§

NotFound

404 Not Found.

  • not_found

The requested endpoint does not exist.

Change your request URL to match a valid API endpoint.

§

MethodNotAllowed

405 Method Not Allowed.

  • method_not_allowed

Method is not allowed for the requested path.

Change your API endpoint to use a valid method.

§

InvalidIdempotentRequest

409 Conflict

  • invalid_idempotent_request

Same idempotency key used with a different request payload.

Change your idempotency key or payload.

§

ConcurrentIdempotentRequests

409 Conflict

  • concurrent_idempotent_requests

Same idempotency key used while original request is still in progress.

Try the request again later.

§

InvalidAttachment

422 Unprocessable Content.

  • invalid_attachment

Attachment must have either a content or path.

Attachments must either have a content (strings, Buffer, or Stream contents) or path to a remote resource (better for larger attachments).

§

InvalidFromAddress

422 Unprocessable Content.

  • invalid_from_address

Invalid from field.

Make sure the from field is a valid. The email address needs to follow the email@example.com or Name <email@example.com> format.

§

InvalidAccess

422 Unprocessable Content

  • invalid_access

Access must be "full_access" | "sending_access".

Make sure the API key has necessary permissions.

§

InvalidParameter

422 Unprocessable Content

  • invalid_parameter

The parameter must be a valid UUID.

Check the value and make sure it’s valid.

§

InvalidRegion

422 Unprocessable Content

  • invalid_region

Region must be "us-east-1" | "us-east-1" | "sa-east-1".

Make sure the correct region is selected.

§

MissingRequiredField

422 Unprocessable Content.

  • missing_required_field

The request body is missing one or more required fields.

Check the error message to see the list of missing fields.

§

DailyQuotaExceeded

429 Too Many Requests.

  • daily_quota_exceeded

You have reached your daily email sending quota.

Upgrade your plan to remove the daily quota limit or wait until 24 hours have passed to continue sending.

§

RateLimitExceeded

429 Too Many Requests.

  • rate_limit_exceeded

Too many requests. Please limit the number of requests per second. Or contact support to increase rate limit.

You should read the response headers and reduce the rate at which you request the API. This can be done by introducing a queue mechanism or reducing the number of concurrent requests per second. If you have specific requirements, contact support to request a rate increase.

§Note

This should never be returned anymore as it’s been replaced by the more detailed Error::RateLimit.

§

SecurityError

451 Unavailable For Legal Reasons

  • security_error

We may have found a security issue with the request.

The message will contain more details. Contact support for more information.

§

ApplicationError

500 Internal Server Error

  • application_error

An unexpected error occurred.

Try the request again later. If the error does not resolve, check our status page for service updates.

§

InternalServerError

500 Internal Server Error.

  • internal_server_error

An unexpected error occurred.

Try the request again later. If the error does not resolve, check our status page for service updates.

Trait Implementations§

Source§

impl Clone for ErrorKind

Source§

fn clone(&self) -> ErrorKind

Returns a duplicate of the value. Read more
1.0.0 · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Debug for ErrorKind

Source§

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

Formats the value using the given formatter. Read more
Source§

impl From<ErrorResponse> for ErrorKind

Source§

fn from(value: ErrorResponse) -> Self

Converts to this type from the input type.
Source§

impl<T: AsRef<str>> From<T> for ErrorKind

Source§

fn from(value: T) -> Self

Converts to this type from the input type.
Source§

impl PartialEq for ErrorKind

Source§

fn eq(&self, other: &ErrorKind) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl Copy for ErrorKind

Source§

impl Eq for ErrorKind

Source§

impl StructuralPartialEq for ErrorKind

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

impl<T> ErasedDestructor for T
where T: 'static,