Fundamentals
This page provides a basic understandings of this API.
Last updated
This page provides a basic understandings of this API.
Last updated
Once you have taken a glance at our API, let's move forward to the next step right now.
We assume you already have knowledge of RESTful APIs and programming languages such as Node.js
or PHP
.
You will need an API_TOKEN
issued by our administrators, which serves as your identity to bypass our security checks. Please keep your token string confidential to prevent any potential malicious activities. We are not responsible if you expose your token string.
API_TOKEN string looks like this: ed45553e-1702-4342-a70d-09bf7ff7f568
We will provide you with one or more accounts for back office login. You can find your API_TOKEN
string in the back office. Accounts will be issued based on your currency requirements. If you need support for multiple currencies, you will require separate accounts for each currency, as each account is designated for a single currency.
Please contact us to obtain your accounts.
Our back office URL is https://sc4-admin.dreamgates.net/
All HTTP requests related to API must include the following HTTP headers.
You can check the API_TOKEN value in the provided manager account's settings and information.
Name | Value | Example |
---|---|---|
In preparation for an attack on this system, simultaneous calls from the same agent are limited to 50 times, and if exceeded, SERVER_IS_BUSY(1018)
is returned.
When this code returns, you must wait for the existing call to complete.
The API can only be called from servers with IP addresses specified in the [Settings] page of our back office. Enter each IP address separated by a space or a new line (e.g., 1.1.1.1 2.2.2.2). If you do not wish to restrict access by IP, leave the [Allowed IP] field blank.
You need to create users in our API first, as we need to identify which user is playing our game. While you may already have a user table in your casino database, our API will synchronize with your existing user data to ensure accurate identification.
Once a user is created, we assign a unique integer called user_code
. This can be used as the player's unique ID.
Everything begins when a player opens one of our games. At that point, you will need to call our API to retrieve a one-time-use game URL. Once the URL is generated, your casino will redirect the player to our game using this URL. From there, the player can place bets and experience wins or losses.
Once the game is launched, the player will start playing. When they place a bet, our API will generate the result based on your casino's RTP settings and record the transaction history. At this stage, our API will need to update the player's balance. If a bet or win/loss is not processed correctly due to unexpected issues, all funds will be refunded to prevent any loss for your players.
The term 'Agent' refers to a single casino website operator. If you manage multiple casinos, you are referred to as an 'Operator'.
An Operator can have multiple Agents under their control, forming a hierarchy. Each Agent operates independently and has their own account for our back office.
As an Operator, you can create as many sub-agents as needed and manage all Agents under your supervision. If you are a broker looking to resell our API, you can create multiple Operators under your management.
You can mange your sub-agents on [Agent/Agents Treeview] page of our back office.
Each agent in the system is assigned a digital wallet. This wallet functions as a repository for their credits, which are referred to as 'points'. These points are essential for the operation of the agent's casino activities. Without sufficient points in their wallet, an agent cannot run or manage their casino operations effectively.
Points can be acquired from higher-level operators, often referred to as parent operators. These parent operators distribute points to their agents, enabling them to maintain and operate their casinos. Essentially, the flow of points from parent operators to agents is crucial for the continuous functioning of the casino system.
The SlotCity API offers 2 integration models: Seamless Mode and Money Transfer Mode
Authorization
Bearer {API_TOKEN}
Authorization: Bearer ed45553e-1702-4342-a70d-09bf7ff7f568
Accept
application/json
Accept: application/json
Content-Type
application/json
Content-Type: application/json