crawlora 1.49.0-sdk.3

Official async Rust client for the Crawlora public web data API
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

use reqwest::StatusCode;
use thiserror::Error;

#[derive(Debug, Error)]
pub enum Error {
    #[error("HTTP transport failed: {0}")]
    Transport(#[from] reqwest::Error),
    #[error("failed to encode or decode JSON: {0}")]
    Json(#[from] serde_json::Error),
    #[error("invalid API base URL: {0}")]
    InvalidBaseUrl(String),
    #[error("unknown Crawlora operation `{0}`")]
    UnknownOperation(String),
    #[error("required parameter `{parameter}` is missing for `{operation}`")]
    MissingParameter {
        operation: String,
        parameter: String,
    },
    #[error("operation `{operation}` requires an API key or JWT token")]
    MissingCredentials { operation: String },
    #[error("Crawlora returned HTTP {status}: {body}")]
    Api {
        status: StatusCode,
        body: String,
        request_id: Option<String>,
    },
    #[error("parameter `{parameter}` for `{operation}` has unsupported value `{value}`")]
    InvalidParameterValue {
        operation: String,
        parameter: String,
        value: String,
    },
    #[error("response was not JSON (content type: {content_type:?})")]
    UnexpectedResponse { content_type: Option<String> },
    #[error("pagination parameter `{parameter}` is not declared by operation `{operation}`")]
    InvalidPaginationParameter {
        operation: String,
        parameter: String,
    },
}

impl Error {
    pub fn status(&self) -> Option<StatusCode> {
        match self {
            Self::Api { status, .. } => Some(*status),
            _ => None,
        }
    }

    pub fn request_id(&self) -> Option<&str> {
        match self {
            Self::Api { request_id, .. } => request_id.as_deref(),
            _ => None,
        }
    }
}