Access to our API is restricted by a token-based authentication. In other words, your account is associated with a unique secret key that is required to connect to the API endpoints.
In order to receive your authentication key please send an email with the subject `Auth Key *identifiable name*` to support@gameye.com and someone will get back to you as soon as possible. This token is private, be careful about how it is shared.
In order for Gameye to pull an image and deploy it across the globe, you need to send a link to your image repository as well as add our Gameye dockerhub user as a team member with read access to your repository. Gameye's dockerhub user is: `gameyedocker`.
Gameye will fire a GET request to the supplied callback(s) URL after the match has ended. The request itself won’t contain any data due to security reasons. We recommend setting the unique match id in the callback URL so you can identify the match. For example, https://example.com/match/uniqueid After receiving the callback you can fetch the statistics for the specific match. In case the supplied URL doesn’t respond with an HTTP 200 status we’ll retry the callback 10 times with 500ms intervals.
Our API returns standard HTTP success or error status codes. If available, we will also include extra information about what went wrong encoded in the response as JSON. The various HTTP status codes we might return are listed below.
Code | Title | Description |
200 | OK | The request was successful. |
400 | Bad Request | Bad request. |
401 | Unauthorized | Your API key is invalid. |
404 | Not found | The resource does not exist. |
429 | Too Many Requests | This server location has reached it's request limit. |
500 | Internal Server Error | An error occurred with our API. |
503 | Service Unavailable | This server location is out of temporary out of capacity. |
504 | Gateway Timeout | Failed to reach one of our internal services. |
You can make 600 requests per minute to each API endpoint, except the Create Session or the Create Start endpoints which are both limited to 300 requests per minute.
If you think you’ll need a higher rate limit, please drop us a message at 'support@gameye.com', with the subject "Rate limit"