API Errors

When ever something doesn’t work the API should send you an error. An error will be look something like this:

HTTP Status: 401

{
    "error": {
        "code": 1001,
        "description": "Auth Token not valid."
    }
}

As you see the error and all API responds use HTTP Status Codes as well as json data to tell you what is happening.
The error json object will tell you an unique code as well as a small description about the error.

HTTP Status codes

The following Status codes are used in API Errors and responds:

200 - OK

Whenever a GET request is successfully executed you will get back a JSON Object and a HTTP 200 status.

201 - Created

If you successfully used a POST request to create or update an object you will receive a HTTP 201 status back. Normally you will also receive json data of the updated object.

400 - Bad Request

Whenever something is wrong with the GET or POST request you sent to us you will receive an HTTP 200 status back as well as an json error object. Please check the description of the json object, if you need additional Information check this Page as well as the documentation about the request you used.

401 - Unauthorized

This will mean that something is wrong with the API token or the Account that is connected to this Token. You will also get an error code back that is starting with a number 1 (1XXX).

404 - Not Found

The requested URL is not supported. We recommend to double check the entered URL.

405 - Method Not Allowed

You tried to send a POST request to an URL that only accept GET Requests or the other way around.

500 - Internal Server Error

This basically means we fucked up. Something is wrong in our API and needs to be fixed please provide us the error Information you receved as json object.

Error Codes

Below you will find our Internal Error Codes. All Error Codes are 4 digits to avoid confusion with HTTP Status Codes. The first number will indicate the error type.

1XXX - Authentication

1000

As the description should have told you, we havn’t received any Auth token.
Check Authentication for more Information.

1001

The token is not correct. It’s possible, that the account the token was from renewed it. To many requests with wrong tokens can ban your server from using our API.
Check Authentication for more Information.

1002

The user of the token has expired. The Owner of the User need to get in contact with us, so we can renew his account access. The token will stay the same if the user is not going to renew it manually.
Token expiry is something different than premium expiry. Token may expire due to security reasons, premium accounts may expire but basically the token is still intact and could still be used after renewing premium

1003

The User Account of the used token doesn’t have access to this feature.

1004

You have reached your hourly limit and can’t create more objects at the moment.

1005

You have reached your daily limit and can’t create more objects at the moment.

2XXX - Not Found

2000

The send game wasn’t found! Make sure the send gameId is valid. You can get all games using this request.

2001

The send map pool wasn’t found! Make sure the send mappoolId is valid. You can get all map pools of a game with this request.

2002

The send best of wasn’t valid. Check the description of the error object for more information.

2003

Map(s) wasn’t found for the game. Make sure the send mapId is valid. You can get all maps of a game with this request.

2004

Lobby wasn’t found. Make sure the lobbyId was valid.

2005

Lobby setting wasn’t found or can’t request/set it.

2006

Mapcount needs to be at least 3.

2007

Vote order not send or isn’t an array.

2008

Team names not send or isn’t an array.

3XXX - Bad Requests

3000

We havn’t received any RAW data for the POST request.

3001

Best of was higher as the numbers of maps.

3002

Ban Lobby has already ben started. Can’t change settings or vote order anymore.

3003

Vote Order isn’t valid! Check Error Description for more!

3004

The game doesn’t use that setting so we can’t set it to true!

3005

This Setting is not possible. Check the documentation of this function for more information.

3006

This API doesn’t support the change of images.

3017

You are not allowed to create that many objects with one call! This Error willbe thrown, when creating more then one lobby and you tried to create more lobbies as the used account is allowed to create with one call.

3018

The Amount of Lobbies you want to create with the call would exceed your allowed hourly limit.

3019

The Amount of Lobbies you want to create with the call would exceed your allowed daily limit.