API Endpoints

Base

• The base URL for API route is: https://api.prodb.eslgaming.com/{version}
• All routes are versioned, more deeply described in Versioning
• All routes are rate limited, please take a deeper look into Rate Limiting

Error response codes

Scenario	Status Code	Description
Internal error	500	Internal server error
Rate limit exceeded	429	Too many requests; wait before retrying.
Unauthorized due to IP restriction	403	IP not allowed; access restricted by IP whitelisting.
Authentication required but not provided or invalid token	401	Authentication failed; valid token required.

Authentication

• URL: https://api.prodb.eslgaming.com/{version}/oauth/token
• See more details in the Authentication section

GraphQL

Queries

• URL: https://api.prodb.eslgaming.com/{version}/graphql
• See more details in the GraphQL section

Subscriptions over WebSocket Protocol

• URL: https://api.prodb.eslgaming.com/{version}/graphql/ws
• Protocol specification: graphql-ws

Images

• URL: https://api.prodb.eslgaming.com/{version}/images/{id}/{resolution}
• Description: This API route is returning images
• Parameters:
  • imageId (String): Unique identifier of the image, corresponding to the id field of the Image GraphQL Type. This ID uniquely identifies the image within the system.
  • resolution (String): Desired resolution. Refer to the resolutions field in the Image GraphQL Type for the exact resolutions available for a specific image. (Default: THUMB)
• Responses
  • 302: Image exists in defined resolution, API redirects to download the image
  • 404: Image does not exist in defined resolution