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};