Skip to main content

jquants_api/
error.rs

1/// jquants-api の全 API が返すエラー型。
2#[derive(Debug, thiserror::Error)]
3pub enum Error {
4    /// 通信レベルの失敗(接続・タイムアウト等)
5    #[error("http error: {0}")]
6    Http(
7        #[doc = "元となった reqwest のエラー"]
8        #[from]
9        reqwest::Error,
10    ),
11
12    /// J-Quants API がエラー応答を返した(認証エラー・パラメータ不正・レート制限等)
13    #[error("api error (status {status}): {message}")]
14    Api {
15        /// HTTP ステータスコード(401=認証エラー、429=レート制限 など)
16        status: u16,
17        /// API が返したエラーメッセージ
18        message: String,
19    },
20
21    /// 応答 JSON を期待した型にデコードできなかった
22    #[error("decode error: {source} (body: {body})")]
23    Decode {
24        /// デコード失敗の原因
25        source: serde_json::Error,
26        /// 応答本文の先頭 500 文字(API 仕様変更の調査用)
27        body: String,
28    },
29
30    /// `from_env` で環境変数 `JQUANTS_API_KEY` が見つからなかった
31    #[error("JQUANTS_API_KEY environment variable is not set")]
32    MissingApiKey,
33}