This page includes test event IDs and other information to make sure your integration works as planned. Use it to trigger different flows in your integration and ensure they are handled accordingly.

Table Tennis API

When using the Table Tennis API in your application, ensure that:

• All required header paramters are set correctly

• You have a valid OAuth Bearer 2.0 token for authentication

• Use the correct URL to get connected to the API

Basic Match IDs

Genuine match ID information cannot be used in test mode. Instead, use any of the following test match ID numbers to make a successful request.

Example of how to connect to a Websocket

Use the following command to get more details about a match associated with the id of 999991.

WebSocket: wss://dde-streams.imgarena.com/tabletennis/999991/matchdetails

Then right after getting connected, a valid authentication token should be sent immediately.

{
  "authToken": "<token>"
}

Example of how to connect to the REST API

Method: GET

URL: https://dde-test-api.imgarena.com/tabletennis/tournaments/

Headers: [Accept] application/vnd.imgarena.dde.api+json;version=1

To make any request to the IMG Arena API, you must first apply for an account and our Support and Integrations team will send you an OAuth Bearer 2.0 token. This token represents your application and enables you to authenticate requests.

Since these tokens do not expire unless regenerated, we suggest creating environment variables or using a secure password manager once you've received your credentials.

Once you have access, you’re ready to get started using the IMG Arena Table Tennis API! We have quick start guides for many of our endpoints, useful tools and libraries and sample code that describe how to build solutions around different use cases.

Polling limits

IMG Arena monitor the incoming traffic from our customers and strive to ensure that traffic is controlled, in-keeping with our guidelines and not unnecessarily excessive. We would suggest a polling rate of 5 requests per second, whilst we strive towards implementing rate limiting.

A single websocket endpoint exists for each match. It is a match details feed and contains an action based play by play representation of a volleyball match.

Endpoint URL

wss://dde-streams.imgarena.com/tabletennis/{id}/matchdetails

Process for connecting to the web socket endpoints

• Connect to SSL websocket address

• Send JSON packet containing API token

• Receive response indicating that connection is authorised (or a response indicating why the connection cannot be made)

• Receive data packets

Once you have the API token, any further data that you send over the connection will be ignored.

Security protocol for WebSockets: Please note that we currently we do not support SSL. We only support the use of TLS Version 1.2+.