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}