Getting Started with Feeds

To facilitate custom feeds from third-party providers, Shape Games Casino requests data through a bridge or adapter interface. Below is an overview of the general process to implement and integrate feeds. For details specific to each feed, refer to the respective feed documentation.

1. Get Access

Before starting the integration, the implementation party need to obtain an API key for establishing a secure connection and establish contact with Shape Games.

For this or any other support questions, you can contact mustafa@shapegames.com

2. Implementation

Each feed specification has a related OpenAPI specification to outline the requirements for the bridge interface. This specification defines the contract and describes the expected data structure, endpoints, and authentication protocols.

Using the OpenAPI specification as a guide, the provider or implementing party develops an endpoint. This endpoint will act as the adapter, bridging the Shape Games Casino system with the third-party recommendation engine’s standard API.

You can integrate with the following feeds:

3. Forward Information to Partner

If you are a 3rd party making the integration, you simply need to provide the URL to the feed for your partner upon setup.

4. Configure Feed for Applications

When the feed has integrated, it will be possible to integrate the feed by contacting mustafa@shapegames.com (Later it will be possible to configure through the Shape Games Control Panel)

Security

To ensure secure communication between Shape Games Casino and the third-party provider, follow these requirements:

API Key Validation

Shape Games Casino uses an API key to authenticate requests. The API key is sent in the request header, formatted as follows:

Authorization: Bearer API-KEY

This API key is unique to each provider and is required for all requests to verify authenticity. The provider must validate this key with each request to confirm secure access.

The API key will be issued at the beginning of the integration as described in the first step of the getting started guide.

Enhanced Security with IP Whitelisting (Optional)

For additional security, we recommend IP whitelisting, where only approved IP addresses can access the feed. This adds a layer of protection by restricting access to requests originating from specific IP addresses.

If the provider opts for IP whitelisting, we request that they open a Jira ticket to specify the IP addresses from which Shape Games Casino will access their services. This will allow us to configure access accordingly.

Fault-Tolerance

In order to guarantee that the Shape Games systems will maintain operations we have implemented some mechanisms to handle unwanted behaviour. This means that:

• If a request towards a feed endpoint takes longer than 3 seconds, the request will be terminated

• We won’t accept payloads larger than 1MB