https://github.com/hexqnt/cbr-client
Strictly-typed, unofficial Rust client for downloading CBR data.
https://github.com/hexqnt/cbr-client
api bank-of-russia cbr http-client
Last synced: 13 days ago
JSON representation
Strictly-typed, unofficial Rust client for downloading CBR data.
- Host: GitHub
- URL: https://github.com/hexqnt/cbr-client
- Owner: hexqnt
- License: apache-2.0
- Created: 2026-03-31T18:10:46.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-03-31T18:46:09.000Z (2 months ago)
- Last Synced: 2026-03-31T18:51:14.931Z (2 months ago)
- Topics: api, bank-of-russia, cbr, http-client
- Language: Rust
- Homepage:
- Size: 0 Bytes
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
Awesome Lists containing this project
README
# cbr-client
[](https://github.com/hexqnt/cbr-client/actions/workflows/ci.yml)
[](https://crates.io/crates/cbr-client)
[](https://docs.rs/cbr-client)
Неофициальная Rust-библиотека для работы с API сервиса статистических данных Банка России:
`https://www.cbr.ru/statistics/data-service/APIdocumentation/`.
## Установка
```toml
[dependencies]
cbr-client = "0.1.0"
```
## Пример (async)
```rust
use cbr_client::{CategoryId, CbrClient, DataNewQuery, IndicatorId, Year, YearSpan};
#[tokio::main]
async fn main() -> Result<(), Box> {
let client = CbrClient::new()?;
let years = YearSpan::new(Year::new(2021), Year::new(2021))?;
let data = client
.data_new(
DataNewQuery::new(CategoryId::new(5)?, years)
.with_i_ids([IndicatorId::new(7)?, IndicatorId::new(8)?]),
)
.await?;
println!("rows: {}", data.row_data.len());
Ok(())
}
```
## Пример (blocking)
```rust
use cbr_client::{
BlockingCbrClient, DataQuery, DatasetId, MeasureId, PublicationId, Year, YearSpan,
};
fn main() -> Result<(), Box> {
let client = BlockingCbrClient::new()?;
let years = YearSpan::new(Year::new(2021), Year::new(2021))?;
let data = client.data(
DataQuery::new(years, DatasetId::new(38)?, PublicationId::new(18)?)
.with_measure_id(MeasureId::new(2)?),
)?;
println!("raw rows: {}", data.raw_data.len());
Ok(())
}
```
## Пример: временной ряд USD/RUB
Готовый пример находится в `examples/usd_rub_time_series.rs`.
В модуле `cbr_client::presets::fx` доступны:
- константные пресеты (`SeriesPreset`)
- параметризованный runtime-резолвер:
- `resolve_fx_series(client, FxPeriodicity, FxMetric)`
- `resolve_fx_series_blocking(...)` (с feature `blocking`)
## Настройка клиента
```rust
use std::time::Duration;
use cbr_client::CbrClient;
let client = CbrClient::builder()
.base_url("https://www.cbr.ru/dataservice")
.timeout(Duration::from_secs(15))
.user_agent("my-app/1.0")
.build()?;
```
## Advanced API (кастомные типы)
Если нужно десериализовать ответ сразу в собственную структуру, используйте generic-методы:
- async: `request_json(path)` и `request_json_with_query(path, &query)`
- blocking (feature `blocking`): `request_json(path)` и `request_json_with_query(path, &query)`
`path` задаётся относительно `base_url`, ведущий `/` необязателен.
```rust
use serde::{Deserialize, Serialize};
use cbr_client::CbrClient;
#[derive(Debug, Deserialize)]
struct MyPayload {
value: i32,
}
#[derive(Debug, Serialize)]
struct MyQuery {
page: u32,
}
#[tokio::main]
async fn main() -> Result<(), Box> {
let client = CbrClient::new()?;
let _payload: MyPayload = client
.request_json_with_query("/some-endpoint", &MyQuery { page: 1 })
.await?;
Ok(())
}
```
### Работа через proxy
```rust
use cbr_client::CbrClient;
let client = CbrClient::builder()
.proxy("http://127.0.0.1:8080")
// Использование системных proxy-переменных окружения:
//.use_system_proxy(true)
.build()?;
```