# smsru
Typed Rust client for the SMS.RU HTTP API (`sms/send`).
This crate focuses on a small, explicit public API: strong domain types for inputs and a client that handles JSON responses. Transport details are internal and not exposed as public modules.
The client is async and expects a Tokio runtime.
## MSRV
Minimum supported Rust version: **1.85** (edition 2024).
## Quickstart
```rust,no_run
use smsru::{Auth, MessageText, RawPhoneNumber, SendOptions, SendSms, SmsRuClient};
# async fn run() -> Result<(), smsru::SmsRuError> {
let client = SmsRuClient::new(Auth::api_id("...")?);
let recipients = vec![
RawPhoneNumber::new("+79255070602")?,
RawPhoneNumber::new("+74993221627")?,
];
let msg = MessageText::new("hello world")?;
let request = SendSms::to_many(recipients, msg, SendOptions::default())?;
let response = client.send_sms(request).await?;
println!("status: {:?} code: {:?}", response.status, response.status_code);
# Ok(())
# }
```
## Authentication
- API key: `Auth::api_id("...")?`
- Login + password: `Auth::login_password("login", "password")?`
## Request shapes
- One message to many recipients: `SendSms::to_many(Vec<RawPhoneNumber>, MessageText, SendOptions)`
- Per-recipient messages: `SendSms::per_recipient(BTreeMap<RawPhoneNumber, MessageText>, SendOptions)`
```rust,no_run
use std::collections::BTreeMap;
use smsru::{MessageText, RawPhoneNumber, SendOptions, SendSms};
fn build() -> Result<SendSms, smsru::ValidationError> {
let mut messages = BTreeMap::new();
messages.insert(
RawPhoneNumber::new("+79251234567")?,
MessageText::new("hello")?,
);
Ok(SendSms::per_recipient(messages, SendOptions::default())?)
}
```
## Phone numbers
- `RawPhoneNumber` preserves input as-is after trimming whitespace.
- `PhoneNumber::parse(default_region, input)` validates and normalizes to E.164. Convert to `RawPhoneNumber` when building requests.
## Client configuration
Use `SmsRuClient::builder(auth)` to configure `endpoint`, `timeout`, and `user_agent`.
## Responses and status codes
Responses preserve SMS.RU status codes via `StatusCode`. Known codes are mapped to `KnownStatusCode` through `StatusCode::known_kind()`.
## JSON-only transport
The client always sends `json=1` and only supports JSON responses. `JsonMode::Plain` is rejected by the client.