nvd_api/
error.rs

1//! nvd api error
2use crate::pagination::Object;
3use serde::{Deserialize, Serialize};
4use std::fmt::{Display, Formatter};
5use std::num::NonZeroU16;
6
7#[derive(Debug, thiserror::Error)]
8pub enum Error {
9  #[error("Invalid NVD API Token: {}", source)]
10  InvalidApiToken {
11    source: reqwest::header::InvalidHeaderValue,
12  },
13
14  #[error("Unable to build reqwest HTTP client: {}", source)]
15  BuildingClient { source: reqwest::Error },
16
17  #[error("Error sending HTTP request: {}", source)]
18  RequestFailed {
19    #[from]
20    source: reqwest::Error,
21  },
22
23  #[error("Error reading response: {}", source)]
24  ResponseIo { source: reqwest::Error },
25
26  #[error("Error parsing json response: {}", source)]
27  JsonParse { source: serde_json::Error },
28
29  #[error("Unexpected API Response")]
30  UnexpectedResponse { response: Object },
31
32  #[error("API Error {}({}): {}", .error.code, .error.status, .error.message)]
33  Api { error: ErrorResponse },
34}
35
36#[derive(Debug, Serialize, Deserialize, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)]
37#[serde(transparent)]
38pub struct StatusCode(NonZeroU16);
39
40impl Display for StatusCode {
41  fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
42    write!(f, "{}", self.0)
43  }
44}
45
46#[derive(Serialize, Deserialize, Eq, PartialEq, Debug, Clone)]
47pub struct ErrorResponse {
48  pub status: StatusCode,
49  pub code: ErrorCode,
50  pub message: String,
51}
52
53#[derive(Serialize, Deserialize, Eq, PartialEq, Debug, Clone)]
54#[serde(rename_all = "snake_case")]
55pub enum ErrorCode {
56  /// The request body could not be decoded as JSON.
57  InvalidJson,
58  /// The request URL is not valid.
59  InvalidRequestUrl,
60  /// This request is not supported.
61  InvalidRequest,
62  /// The request body does not match the schema for the expected parameters. Check the "message" property for more details.
63  MissionVersion,
64  /// The bearer token is not valid.
65  Unauthorized,
66  /// Given the bearer token used, the client doesn't have permission to perform this operation.
67  RestrictedResource,
68  /// Given the bearer token used, the resource does not exist. This error can also indicate that the resource has not been shared with owner of the bearer token.
69  ObjectNotFound,
70  /// The transaction could not be completed, potentially due to a data collision. Make sure the parameters are up to date and try again.
71  ConflictError,
72  /// This request exceeds the number of requests allowed. Slow down and try again. More details on rate limits.
73  RateLimited,
74  /// An unexpected error occurred. Reach out to NVD support.
75  InternalServerError,
76  /// NVD is unavailable. Try again later. This can occur when the time to respond to a request takes longer than 60 seconds, the maximum request timeout.
77  ServiceUnavailable,
78  #[serde(other)] // serde issue #912
79  Unknown,
80}
81
82impl Display for ErrorCode {
83  fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
84    write!(f, "{self:?}")
85  }
86}
nvd_api/error.rs

nvd_api/
error.rs
