Getting a key and secret
Before any calls can be made to the API, you must first have a key/secret pair that is used to authenticate your application. This key is associated with a set of permissions on a per server basis and the key/secret is only valid for that server.
The key/secret pair is associated only with one server and that is the server it is created on
To get an key/secret, go to Virtual/Dedicated Server -> Sub accounts/API Keys and click Create new. This creates a key/secret with no permissions so it is recommended that you grant it permissions under Permissions. The secret for your key can be retrieved via the Display secret button.
The secret cannot be reset at this time so if it is compromised, you will need to delete and generate a new key.
Each key/secret pair has a set of permissions associated with it. This limits the endpoints you can call depending upon the permission. Permissions are broken down generally per game then a set of specific operations within that game such as console access.
When making calls to endpoints, you will need to pass in key/secret pair within the form data. Pass the key inside the
key field and secret inside the
If the API credentials are invalid, you will receive a response with
status set to
Invalid API credentials. . You can see more detailed information in the
Example error response:
"message": "Invalid API credentials.",
"details": "Key or secret are too short."