OAuth 1.0a crate

This crate provides an OAuth 1.0a client implementation fully-async with logging, metrics and tracing facilities. It was firstly designed to interact with the Clever-Cloud's API, but has been extended to be more generic.

Status

This crate is ready for production. If you find a bug, please open an issue.

Installation

To install this dependency, just add the following line to your Cargo.toml manifest.

oauth10a = { version = "^2.1.2", features = ["metrics"] }

Usage

Below, you will find an example of executing a simple request to an API.

use oauth10a::{client::Client, credentials::Credentials, rest::RestClient};

type MyData = std::collections::BTreeMap<String, String>;
type MyError = String;

#[tokio::main]
async fn main() -> Result<(), Box<dyn core::error::Error + Send + Sync>> {
    let client = Client::new().with_credentials(Credentials::OAuth1 {
        token: "",
        secret: "",
        consumer_key: "",
        consumer_secret: "",
    });

    match client.get::<MyData, MyError>("https://example.com/object.json").await {
        // received HTTP response with JSON payload deserializing to `MyData`
        Ok(Ok(response)) => (),
        // received HTTP error response with JSON payload deserializing to `MyError`
        Ok(Err(error_response)) => (),
        // client failed to execute request
        Err(rest_error) => ()
    }

    Ok(())
}

Features

Metrics

Below, the exposed metrics gathered by prometheus:

License

See the license.

Getting in touch

• @FlorentinDUBOIS