Enum MyIdError 

#[non_exhaustive]
pub enum MyIdError {
    Config {
        message: String,
    },
    Validation {
        message: String,
    },
    Http(Error),
    Api {
        status: u16,
        message: String,
    },
    Internal {
        message: String,
    },
}

MyID SDK ning asosiy xatolik tipi.

Barcha SDK operatsiyalari xato bo’lganda shu enum qaytariladi. Har bir variant alohida xato kategoriyasini ifodalaydi.

Misollar

use myid::error::MyIdError;

// Config xatosi
let err = MyIdError::config("noto'g'ri URL formati");
println!("{err}"); // "config error: noto'g'ri URL formati"

// API xatosi
let err = MyIdError::api(401, "unauthorized");
println!("{err}"); // "api error 401: unauthorized"

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.

Config

Konfiguratsiya xatosi.

Config::new(), Config::from_env(), yoki with_*() metodlarida validatsiya muvaffaqiyatsiz bo’lganda qaytariladi.

Misol

use myid::config::Config;
use myid::error::MyIdError;

let err = Config::new("ftp://example.uz", "id", "secret").unwrap_err();
assert!(matches!(err, MyIdError::Config { .. }));

Fields

message: String

Xato haqida batafsil ma’lumot.

Validation

Ma’lumotlarni validatsiya xatosi.

So’rov parametrlari noto’g’ri yoki yetishmagan bo’lganda qaytariladi. Masalan: majburiy field bo’sh, format noto’g’ri, qiymat chegaradan tashqarida.

Qachon yuz beradi

Sabab	Misol
Majburiy field bo’sh	photo berilmagan
Format noto’g’ri	birth_date noto’g’ri format
Qiymat chegaradan tashqari	passport_series 2 belgidan kam

Misol

use myid::error::MyIdError;

let err = MyIdError::validation("photo maydoni majburiy");
assert!(matches!(err, MyIdError::Validation { .. }));
println!("{err}"); // "validation error: photo maydoni majburiy"

Fields

message: String

Qaysi field yoki qiymat noto’g’ri ekanligi haqida batafsil ma’lumot.

Http(Error)

HTTP transport xatosi.

reqwest kutubxonasi qaytargan xatolar avtomatik convert bo’ladi. Timeout, DNS resolution, TLS handshake, connection refused va boshqa tarmoq xatoliklari shu variantga tushadi.

Qachon yuz beradi

• Server javob bermasa (timeout)
• DNS nomi topilmasa
• TLS sertifikat xatosi
• Connection refused
• Response body parse bo’lmasa

Api

API javobidagi xato (4xx/5xx status kodlari).

MyID serveri so’rovni qabul qildi, lekin xato javob qaytardi. status — HTTP status kodi, message — server javobi.

Tez-tez uchraydigan kodlar

Status	Sababi
400	Noto’g’ri so’rov parametrlari
401	client_id yoki client_secret noto’g’ri
403	Ruxsat berilmagan
429	Rate limit — juda ko’p so’rov
500	Server ichki xatosi

Fields

status: u16

HTTP status kodi (masalan: 401, 403, 500).

message: String

Server qaytargan xato xabari.

Internal

SDK ichki xatosi.

Odatiy foydalanishda yuz bermasligi kerak. Mutex lock poisoning yoki boshqa kutilmagan holatlar uchun.

Fields

message: String

Ichki xato haqida ma’lumot.

Implementations

impl MyIdError

pub fn config(message: impl Into<String>) -> Self

MyIdError::Config variantini yaratadi.

Misollar

use myid::error::MyIdError;

let err = MyIdError::config("noto'g'ri URL");
let err = MyIdError::config(format!("yo'q: {}", "MYID_BASE_URL"));

pub fn validation(message: impl Into<String>) -> Self

MyIdError::Validation variantini yaratadi.

use myid::error::MyIdError;

let err = MyIdError::validation("passport_series majburiy");

pub fn http(source: Error) -> Self

MyIdError::Http variantini reqwest::Error dan yaratadi.

Odatda ? operatori orqali avtomatik convert bo’ladi (#[from]). Bu metod faqat qo’shimcha kontekst kerak bo’lganda ishlatiladi.

pub fn api(status: u16, message: impl Into<String>) -> Self

MyIdError::Api variantini yaratadi.

Misollar

use myid::error::MyIdError;

let err = MyIdError::api(401, "unauthorized");
let err = MyIdError::api(500, "internal server error");

pub fn is_api(&self) -> bool

Xato API xatosimi yoki yo’qligini tekshiradi.

use myid::error::MyIdError;

let err = MyIdError::api(401, "unauthorized");
assert!(err.is_api());

pub fn api_status(&self) -> Option<u16>

API xato bo’lsa status kodini qaytaradi.

use myid::error::MyIdError;

let err = MyIdError::api(429, "rate limited");
assert_eq!(err.api_status(), Some(429));

Trait Implementations

impl Debug for MyIdError

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

Formats the value using the given formatter.

impl Display for MyIdError

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

Formats the value using the given formatter.

impl Error for MyIdError

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 MyIdError

fn from(source: Error) -> Self

Converts to this type from the input type.