https://github.com/gsquire/sendgrid-rs

Unofficial Rust library for the SendGrid API
https://github.com/gsquire/sendgrid-rs

rust sendgrid-api

Last synced: 19 days ago
JSON representation

Unofficial Rust library for the SendGrid API

• Host: GitHub
• URL: https://github.com/gsquire/sendgrid-rs
• Owner: gsquire
• License: mit
• Created: 2015-10-06T04:36:35.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2024-10-10T23:29:51.000Z (24 days ago)
• Last Synced: 2024-10-10T23:41:32.697Z (24 days ago)
• Topics: rust, sendgrid-api
• Language: Rust
• Homepage: https://crates.io/crates/sendgrid
• Size: 133 KB
• Stars: 107
• Watchers: 3
• Forks: 50
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-rust-cn - gsquire/sendgrid-rs - ci.org/gsquire/sendgrid-rs.svg?branch=master">](https://travis-ci.org/gsquire/sendgrid-rs) (Libraries / Email)
• awesome-rust - gsquire/sendgrid-rs - ci.org/gsquire/sendgrid-rs.svg?branch=master">](https://travis-ci.org/gsquire/sendgrid-rs) (Libraries / Email)
• awesome-rust - gsquire/sendgrid-rs
• awesome-rust-cn - gsquire/sendgrid-rs - 非官方的铁锈库SendGrid (库 Libraries / 电子邮件 Email)
• awesome-rust-zh - gsquire/sendgrid-rs - SendGrid API 的非官方 Rust 库[<img src="https://api.travis-ci.org/gsquire/sendgrid-rs.svg?branch=master">](https://travis-ci.org/gsquire/sendgrid-rs) (库 / 电子邮件)
• awesome-rust - gsquire/sendgrid-rs - Library for SendGrid API (Libraries / Email)
• awesome-rust - gsquire/sendgrid-rs - ci.org/gsquire/sendgrid-rs.svg?branch=master">](https://travis-ci.org/gsquire/sendgrid-rs) (库 Libraries / 邮件 Email)
• fucking-awesome-rust - gsquire/sendgrid-rs - Library for SendGrid API (Libraries / Email)
• fucking-awesome-rust - gsquire/sendgrid-rs - Library for SendGrid API (Libraries / Email)

README

        
# sendgrid-rs

Unofficial Rust library for the SendGrid API.

This crate requires Rust 1.15 or higher as it uses a crate that has a custom derive implementation.

sendgrid-rs implements all of the functionality of other supported SendGrid client libraries.

To use sendgrid-rs you must first create a SendGrid account and generate an API key. To create an API

key for your SendGrid account, use the account management interface or see the

[SendGrid API Documentation](https://sendgrid.com/docs/API_Reference/Web_API_v3/API_Keys/index.html).

sendgrid-rs is available on [crates.io](https://crates.io/crates/sendgrid) and can be included in your Cargo.toml as follows:

```toml

[dependencies]

sendgrid = "X.X.X"

```

## Build Dependencies

This library utilises [reqwest](https://crates.io/crates/reqwest). Follow the instructions on the

[reqwest README](https://github.com/seanmonstar/reqwest#requirements) in order to enable sending HTTPS

requests to the SendGrid API.

## Features

You can take advantage of a couple features for the crate. To enable the blocking send function, you

can use the `blocking` flag. To enable the [rustls](https://github.com/rustls/rustls) TLS feature,

use the `rustls` flag.

## Example

An example of using this library can be found in the examples directory. This example code expects to

find your SendGrid API key in the process environment. In shells such as Bash or ZSH this can be set as follows:

```shell

export SENDGRID_API_KEY="SG.my.api.key"

```

```shell

SENDGRID_API_KEY=SG.... cargo run --example v3_disable_tracking --features="blocking" [email protected] [email protected]

```

## Documentation

[Documentation](https://docs.rs/sendgrid)

Please don't hesitate to contact me at the email listed in my profile. I will

try to help as quickly as I can. If you would like to contribute, contact me

as well.

## Mentions

Thanks to [meehow](https://github.com/meehow) for their contributions.

Thanks to [richo](https://github.com/richo) for their improvements to the V2 API.

## License

MIT