SuperLink Documentation

Back to Homepage

---

SuperLink

Super link is a new generation Discord bot utilizing Spring Boot to create Discord and Minecraft account links

Status codes

• HTTP 404 NOT FOUND - Returns empty body
• HTTP 500 INTERNAL SERVER ERROR - Returns error object

Error object example:

{
    "name": "RuntimeException",
    "message": "User not found",
    "path": "/api/user/651476404201979926/06805a4280d0463dbf7151b1e1317cd4",
    "timestamp": 1656578263538
}

Endpoints

Application supports a big list of endpoints with loads of customization to suite everyone's needs

Mojang API Cache

• GET /api/cache/uuid/{uuid}
• GET /api/cache/name/{name}

Query parameter ?ignore=1 allows you to skip the cache update and use the value from the database. Recommended use on websites since it drastically speeds up username loading time.

Link data

• GET /api/data - Paged response with all links
• GET /api/data/{id}
• GET /api/data/uuid/{uuid}
• GET /api/data/uuid/{uuid}/history - List of all link data for account
• GET /api/data/discord/{id}
• GET /api/data/discord/{id}/history - List of all link data for user
• GET /api/data/guild/{id} - Paged response of all links in a guild
• GET /api/data/created/after/{date} - Lists all links created after said date
• GET /api/data/deleted/after/{date} - Lists all links deleted after said date

Discord User/Member

• GET /api/user/{uuid} - Retrieves discord user
• GET /api/user/{guild}/{uuid} - Retrieves discord member based of the discord server id
• GET /api/user/{guild}/{role}/{uuid} - Retrieves discord member based of the discord server id and target role id

Request params supporter and moderator are available for requests that contain path param guild. They need to represent a text channel id from that guild and will be checked if the member can talk in theme

Minecraft server status

• GET /api/status/{hostname} - Status for domain (detects SRV record) or an IP with default port
• GET /api/status/{hostname}/{port} - Status for domain or IP with custom port

Application Info

• GET /api/info
• GET /api/info/guilds

Lookup

• GET /api/lookup/{name}
• GET /api/lookup/{guild}/{name}
• GET /api/lookup/{guild}/{role}/{name}

Ban

• GET /api/ban
• GET /api/ban/{id}
• GET /api/ban/user/{id}
• GET /api/ban/admin/{id} - All bans by admin, ID is admins discord user id
• GET /api/ban/guild/{id} - All bans by guild where the ban was done, ID is discord guild id