Explorative and now Archived Software

.. and its only purpose was for me to learn about Java. So keep that in mind!

OAuth2Discord

A little OAuth2 Wrapper for Discord.

Features

• Generation of Authorization URI
• Code-Exchange and getting the access and refresh token
• Revocation of Access-Token
• Refreshing of Access-Token with Refresh-Token
• Get guilds / user / connections information of user

How to add it

Maven

<repositories>
  <repository>
    <id>jitpack.io</id>
    <url>https://jitpack.io</url>
  </repository>
</repositories>

<dependency>
  <groupId>com.github.HayateLaTech</groupId>
  <artifactId>OAuth2Discord</artifactId>
  <version>-SNAPSHOT</version>
</dependency>

Gradle

allprojects {
  repositories {
    ...
    maven { url 'https://jitpack.io' }
  }
}

dependencies {
    implementation 'com.github.HayateLaTech:OAuth2Discord:-SNAPSHOT'
}

Jitpack

Or build it locally..

How does it work

1. Instantiate the OAuthBuilder like this:

import bell.oauth.discord.main.OAuthBuilder;

OAuthBuilder builder = new OAuthBuilder("clientID", "clientSecret")
                          .setScopes(new String[]{"connections", "guilds", "email"})
                          .setRedirectURI("RedirectURL");

2. Get the Authorization URL:

import bell.oauth.discord.main.OAuthBuilder;

String authURL = builder.getAuthorizationUrl(null);

3. Exchange the Code you get from the redirect (as a GET parameter):

import bell.oauth.discord.main.OAuthBuilder;
import bell.oauth.discord.main.Response;

Response response = builder.exchange(code);

if (response == Response.ERROR) {
  // AN ERROR HAPPENED WHILE EXCHANGING THE CODE
} else {
  // EVERYTHING WORKED AS EXPECTED
}

• Get User-Information (only available with scopes email or identify):

import bell.oauth.discord.main.OAuthBuilder;
import bell.oauth.discord.domain.User;

User user =  builder.getUser();

• Get Guilds-Information (only available with scope guilds):

import bell.oauth.discord.main.OAuthBuilder;
import bell.oauth.discord.domain.Guild;
import java.util.List;

List<Guild> guilds = builder.getGuilds();

• Get Connections-Information (only available with scope connections):

import bell.oauth.discord.main.OAuthBuilder;
import bell.oauth.discord.domain.Connection;
import java.util.List;

List<Connection> connections = builder.getConnections();

• Refresh the access-token:

import bell.oauth.discord.main.OAuthBuilder;
import bell.oauth.discord.main.Response;

Response response = builder.refresh();

if (response == Response.ERROR) {
  // AN ERROR HAPPENED WHILE EXCHANGING THE CODE
} else {
  // EVERYTHING WORKED AS EXPECTED
}

• Revoke the access-token:

import bell.oauth.discord.main.OAuthBuilder;
import bell.oauth.discord.main.Response;

Response response = builder.revoke();

if (response == Response.ERROR) {
  // AN ERROR HAPPENED WHILE EXCHANGING THE CODE
} else {
  // EVERYTHING WORKED AS EXPECTED
}

TODO

• Invite workflow