Postmark

A rust library to query Postmark API.

Usage

Add the crate dependency to your Cargo.toml:

[dependencies]
postmark = "x.y.z"

And use it, see documentation at: https://docs.rs/postmark.

use postmark::api::email::SendEmailRequest;
use postmark::api::Body;
use postmark::reqwest::PostmarkClient;
use postmark::Query;

async fn send_email(){
  let client = PostmarkClient::builder()
   .server_token("<sometoken>")
   .build();

  let req = SendEmailRequest::builder()
    .from("me@example.com")
    .to("you@example.com")
    .body(Body::text("it's me, Mario!".to_string()))
    .build();
  let resp = req.execute(&client).await;
}

Messages example:

use postmark::api::messages::OutboundSearchRequest;
use postmark::reqwest::PostmarkClient;
use postmark::Query;

async fn list_messages() {
  let client = PostmarkClient::builder()
    .server_token("<sometoken>")
    .build();

  let request = OutboundSearchRequest::builder().build();
  let response = request.execute(&client).await;
}

API coverage

Detailed endpoint matrix and examples:

• docs/api/postmark-endpoints.md
• docs/api/examples/
• docs/api/compatibility.md

Current high-level status:

Releasing a new version

Prerequisite:

cargo install cargo-release

On Release:

cargo release --dry-run
# check it does the good thing
cargo release

Thanks

This crate's API design is heavily inspired by the article "Designing Rust bindings for REST APIs by Ben Boeckel.

License

postmark-rs is dual-licensed under either:

• MIT License (LICENSE-MIT)
• Apache License, Version 2.0 (LICENSE-APACHE)