Basic Authentication (REST)

Acquiring the Authentication Token

Authentication is fairly simple. We use an Authentication-token based model. To get this token, please get an account email & password and post to the /login endpoint

Login to account

POST https://api.disadus.app/login

Request Body

Name	Type	Description
email*	String	User Email
password*	String	User Password

200: OK Valid login credentials

{
    "success": true,
    "token": "AuthToken"
}

401: Unauthorized Invalid Login Credentials

Once you receive the token, store it somewhere safe! At the moment, these tokens do NOT Automatically expire!!! Making a request with the token is fairly simple, just prepend Bearer to the token and send it via the Authorization header. Try out the following below!

Get Self User Data

GET https://api.disadus.app/user/@me

Headers

Name	Type	Description
Authorization*		Your authorization header ( Bearer AuthToken)

200: OK User Object (Auth Token works correctly)

{
    "id": "TET00",
    "username": "teto",
    "email": "[email protected]",
    "firstName": "John",
    "lastName": "Li",
    "bio": "The *good*? kind of weird and dumb. :think:",
    "pfp": "https://profiles.disadus.app/TET00/0JP9R5L1BD1R2XSU3WO3.png",
    "communities": [
        "tet",
    ],
    "createdAt": 1,
    "primaryCommunity": "gunnSandbox",
    "isAdmin": true,
    "theme": 1,
    "staffLevel": 5,
    "tester": true,
    "premiumUntil": 1634625867038000,
    "openLinkStyle": 0,
    "devMode": true,
    "pluginMode": true,
    "tags": [
        "artist"
    ]
}

404: Not Found Could not get /user/@me (Auth Token does not works correctly)