aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: c051429684b2ef168ec5fbc96f26b8791a36a176 (plain) (blame)
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
# serenity-oauth

`serenity-oauth` is a collection of HTTP library support bridges for
interacting with the OAuth2 API that Discord uses.

It includes support for sending code exchange requests and refresh token
requests.

Included are models in the `model` directory that represent request bodies
and response bodies. The `Scope` enum represents possible OAuth2 scopes
that can be granted.

In the `utils` module, functions to produce authorization URLs are
available. For example, `utils::bot_authorization_url` can be used to
produce a URL that can be used to redirect users to authorize an application
with the `Scope::Bot` scope.

### Installation

Add the following to your `Cargo.toml`:

```toml
[dependencies]
serenity-oauth = { git = "https://github.com/serenity-rs/oauth" }
```

And then the following to your `main.rs` or `lib.rs`:

```rust
extern crate serenity_oauth;
```

### Examples

For an example of how to use this in a real-world program, see the [`examples`]
directory.

### License

This project is licensed under [ISC][license].

[license]: https://github.com/serenity-rs/oauth/blob/master/LICENSE.md
[`examples`]: https://github.com/serenity-rs/oauth/tree/master/examples