Ninja Bot implements OAuth2 using discord's developer application and extends the OAuth pathway by introducing JWTs as a way of implementing instant token verification.

Get Authorization Token

Redirects to Discord's authorization page for Ninja Bot. Optionally takes a query string if the return url is different from https://ninjabot.site/app

Example Url

https://api.ninjabot.site/login?return=https%3A%2F%2Fdevelop.ninjabit.site%2Fapp

This example redirects to https://develop.ninjabot.site/app instead of the main app after the login chain is completed.

When the browser arrives back at the app the URL includes the authorization code provided by discord.

Example Url

https://ninjabot.site/app?code=fKhB9VoUHR8CtZM3XOUnNRS9wSTOrt

Get Ninja Bot API Token

Exchange discord user token, retrieved from login for an Ninja Bot API token.

Json Params

Field	Type	Description
code	string	Discord Authorization Token

Response Example

{
  "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ8.eyJhY2Nlc3NfdG9rZW4iOiJNM05EV1puVEl1Qmk2cG4wNFFmeUNHUG10MGpFTF0iLCJleHBpcmVzZ2luIjo2MDQ4MDAsInJlZnJlc2hfdG9rZW4iOiJXWFo1SUFCRHpWOENEQWR6Y21VVVRiTjg0SURIOXgiLCJ1c2VybmFtZSI6ImpvaG55YnVyZCIsImRpc2NyaW1pbmF0b3IiOiIxMDIyIiwiYXZhdGFyIjoiOWNlNWEwMDY1NDhmMWQlM2U1YzhmYjkxYTRkNjc3ZTQiLCJpZCI6IjIxNDAzNzEzNDQ3NzIzMDA4MCK9.2vEM3IjRPAfytMCdPq0gOIoe_lCwZ6MG7OF8WT73Bju",
  "expires_in": 604800,
  "refresh_token": "WXZ5IABDzV8CDBdzcmUUTbN84IDH9x",
  "username": "johnyburd",
  "discriminator": "1022",
  "avatar": "9ce5a006548f1ae3e5c8fb91a4d677e4",
  "id": "214037134477230080"
}