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
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114

//! # Authy
//! [![](https://docs.rs/authy/badge.svg)](https://docs.rs/authy) [![](https://img.shields.io/crates/v/authy.svg)](https://crates.io/crates/authy) [![](https://img.shields.io/crates/l/authy.svg)](https://raw.githubusercontent.com/lholden/authy-rs/master/LICENSE) [![](https://travis-ci.org/lholden/authy-rs.svg?branch=master)](https://travis-ci.org/lholden/authy-rs)
//!
//! Bindings for the Authy two factor web service
//!
//! ## Usage
//!
//! You will need your API key for your application on [authy.com](https://authy.com).
//!
//! Be sure to add the authy crate to your `Cargo.toml`:
//!
//! ```toml
//! [dependencies]
//! authy = "*"
//! ```
//!
//! 'low-level' Usage example:
//!
//! ```rust
//! extern crate authy;
//! use authy::{Client, AuthyError};
//! use authy::api::user;
//!
//! fn main() {
//!     let api_url = "https://sandbox-api.authy.com";
//!     let api_key = "bf12974d70818a08199d17d5e2bae630";
//!
//!     let c = Client::new(api_url, api_key);
//!     # // Just bumping up the values up so that the test suite doesn't 
//!     # // interact poorly with this.
//!     # let mut c = Client::new(api_url, api_key);
//!     # c.retry_count = 10;
//!     # c.retry_wait = 3000;
//!
//!     let country_code = 1;
//!     let email = "user@domain.com";
//!     let phone = "949-555-1234";
//!
//!     let (_, user) = user::create(&c, email, country_code, phone, true).unwrap();
//!     
//!     println!("We have a user: {:#?}", user);
//!
//!     let code = "000000"; // Pretend user has provided a valid code
//!     match user::verify(&c, user.id, code) {
//!         Ok(_) => println!("Congrats on being validated!"),
//!         Err(AuthyError::UnauthorizedKey(e)) => println!("Token provided by the user was wrong"),
//!         Err(e) => println!("Some server error: {:?}", e),
//!     };
//!
//!     // Lets send out a sms token just for fun
//!     // Must be using a real API key on the production authy server for this to
//!     // actually send out anything.
//!     user::sms(&c, user.id, true, Some("login"), Some("Authy documentation example login")).unwrap();
//! }
//! ```
//!
//!
//! 'high-level' Usage example:
//!
//! ```rust
//! extern crate authy;
//! use authy::{Client, User};
//!
//! fn main() {
//!     let api_url = "https://sandbox-api.authy.com";
//!     let api_key = "bf12974d70818a08199d17d5e2bae630";
//!
//!     let c = Client::new(api_url, api_key);
//!     # // Just bumping up the values up so that the test suite doesn't 
//!     # // interact poorly with this.
//!     # let mut c = Client::new(api_url, api_key);
//!     # c.retry_count = 10;
//!     # c.retry_wait = 3000;
//!
//!     let country_code = 1;
//!     let email = "user@domain.com";
//!     let phone = "949-555-1234";
//!
//!     let mut user = User::create(&c, email, country_code, phone, true).unwrap();
//!     
//!     println!("We have a user: {:#?}", user);
//!
//!     let code = "000000"; // Pretend user has provided a valid code
//!     if user.verify(&c, code).unwrap() {
//!         println!("Congrats on being validated!");
//!     }
//!
//!     // Lets send out a sms token just for fun
//!     // Must be using a real API key on the production authy server for this to
//!     // actually send out anything.
//!     user.sms(&c, true, Some("login"), Some("Authy documentation example login")).unwrap();
//! }
//! ```

extern crate reqwest;

#[macro_use]
extern crate serde_derive;
extern crate serde_json;

mod error;
pub use error::AuthyError;

mod client;
pub use client::{Client, Status};

pub mod api;

pub mod user;

pub use user::{User, PhoneCall, ActivityType};

pub mod phone;
pub use phone::{Phone, ContactType, PhoneStart};