blooio 0.2.1

Typed, low-overhead Rust client for the Blooio API (iMessage/SMS automation), with sync and async surfaces.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

//! Distinguishing the kinds of failure a call can return, and branching on the
//! stable machine-readable API error `code`.
//!
//! ```sh
//! BLOOIO_API_KEY=sk_... CHAT_ID=chat_... cargo run --example error_handling
//! ```

#![allow(clippy::print_stdout)]

use std::env;

use blooio::{Client, Error};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new(env::var("BLOOIO_API_KEY").unwrap_or_else(|_| "sk_demo_key".into()))?;
    let chat = client.chat(env::var("CHAT_ID").unwrap_or_else(|_| "chat_demo".into()));

    match chat.send_text("hello").await {
        Ok(resp) => println!("delivered: {:?}", resp.ids()),

        // A non-2xx response. Match on `code` for stable handling rather than
        // scraping the human-readable message.
        Err(Error::Api {
            status,
            code,
            message,
            ..
        }) => match code.as_deref() {
            Some("outbound_limit_reached") => {
                println!("rate limited — back off and retry later");
            }
            Some("invalid_chat") => println!("that chat id doesn't exist"),
            _ => println!("api error {status}: {message}"),
        },

        // Connection / DNS / TLS / timeout — usually worth retrying.
        Err(Error::Transport(e)) => println!("transport failure (retryable): {e}"),

        // The server sent a 2xx body we couldn't decode — a client/server
        // version skew. Not retryable on its own.
        Err(Error::Decode(e)) => println!("could not decode response: {e}"),

        Err(other) => println!("unexpected error: {other}"),
    }

    // The same information is available without destructuring, via accessors:
    if let Err(e) = client.account().get().await {
        println!("status={:?} code={:?}", e.status(), e.code());
    }

    Ok(())
}