Fragbots

Get Fragbots

GET https://fragbots.antonio32a.com/

This endpoint returns all online fragbots and their queues.

200 Fragbots successfully retrieved.

[
    {
        "username": "frag1",
        "guildId": "something",
        "queue": [ 
            "user1", 
            "user2"
        ]
    },
    {
        "username": "frag2",
        "guildId": "something",
        "queue": [ 
            "user3", 
            "user5", 
            "user5" 
        ]
    }
]

Get Whitelist

GET https://fragbots.antonio32a.com/whitelist

This endpoint returns all trimmed Minecraft UUIDs of all people who are whitelisted.

200 Whitelist successfully retrieved.

[
    "6c0254d81d9041bdb75fdca14935fd3e",
    "689ff4bbf61e4e0594e01066892b0bbe"
]

Get User

GET https://fragbots.antonio32a.com/user

This endpoint returns your user data.

Path Parameters

Name	Type	Description
token	string	Your authentication token.

200 User data successfully retreived.

{
    "success": true,
    "invites": 32,
    "uuid": "6c0254d81d9041bdb75fdca14935fd3e",
    "discord": "166630166825664512"
}

400 You didn't provide all of the request parameters.

{
    "success": false
}

403 Invalid token.

{
    "success": false,
    "error": "Invalid token."
}

Authentication

Authenticating allows you to get a token which is used for some of the requests listed above.

1. Send Mojang the hash

POST https://sessionserver.mojang.com/session/minecraft/join

This endpoint tells Mojang that you're joining a server, but in our case it's used to confirm the hash.

Request Body

Name	Type	Description
accessToken	string	Your Minecraft access token, AKA session ID.
selectedProfile	string	Your Minecraft UUID.
serverId	string	Randomly generated Minecraft hex digest.

200 Request was successful, no content.

2. Send neppy backend the hash

POST https://fragbots.antonio32a.com/authenticate

This endpoint tells neppy backend your username and your hash so it can be verified. This must be sent after the first request.

Path Parameters

Name	Type	Description
hash	string	Randomly generated Minecraft hex digest from the previous request.
username	string	Your Minecraft username-

200 Authentication was successful.

{
    "success": true,
    "token": "tX2NfdAOIcM19I3PfAtjYDuto8HdAow0d4zQLSM32iMD5H1GIeYY47nktr46NXP",
    "expiresAt": 1616853123922
}

400 Your didn't provide all of the request parameters

{
    "success": false
}

403 The hashes didn't match.

{
    "success": false
}

3. Renew the token every 4 hours

POST https://fragbots.antonio32a.com/renew

This endpoint will renew your session.

Path Parameters

Name	Type	Description
token	string	The token obtained in step 2.

200 Token was successfully renewed.

{
    "success": true,
    "expiresAt": 1616853123922
}

400 You didn't provide all of the request parameters.

{
    "success": false
}

403 Invalid token.

{
    "success": false,
    "error": "Invalid token."
}