Games API

---

Games API Reference - Supplier API

---

Get a Game URL

---

post

Returns the landing URL of the chosen game to which Hub88 will forward the user to. There are several ways to forward the User, but make sure game_code is present in the request. 1. Embed URL into iframe on your site; 2. Redirect User to URL; 3. Open URL in new window/tab of browser.

Header parameters

X-Hub88-SignatureanyRequired

RSA-SHA256 is used to sign the request body using the private key. The signature is validated using the public key associated with the provided operator_id.

Body

userstringOptional

The unique user ID in the Hub88's system. In case of DEMO gameplay, this parameter may be omitted.

Example: john12345

tokenstringOptional

Hub88 generates a token associated with the user, game, and active currency. The token acts as an ID parameter for the game session. It is important that the currency is not changed during the current game session. If the user changes the currency, the game must be re-opened with new a token. For DEMO gameplay, this parameter may be omitted. Minimum length 10 characters, maximum length 255 characters.

Example: f562a685-a160-4d17-876d-ab3363db331c

sub_partner_idstringOptional

ID of an Hub88's sub-partner (brand, whitelabel, site, etc.) which uses the same integration and credentials as the Hub88. Used for detailed reporting and integration type switching.

Example: my-casino-id

platformstring · enumRequired

The platform layout, either mobile or desktop, the User has. This property can be ignored, if the mode is chosen based on User's browser attributes (user-agent, resolution, ratio, orientation)

Example: GPL_DESKTOPPossible values:

operator_idintegerRequired

The unique identifier of Hub88 configuration in the Supplier's system used to authorize incoming requests. Could be either interger or a string.

Example: 1

metaobjectOptional

Additional parameters, can be used for certain game Supplier. It depends on the Operator's choice of a game Supplier.

lobby_urlstringRequired

lobby_url specifies the URL to which the game redirects to when the user clicks the Home button in the UI. Maximum length 255 characters.

Example: https://amazing-casino.com/lobby

langstring · enumRequired

The ISO 639-1 language code, applicable to the User in the current session.

Example: enPossible values:

ipstringRequired

The user's IP address.

Example: 142.245.172.168

game_codestring | nullOptional

The unique game identifier in Provider's system in the form of a string. game_code can be obtained from the /game/list endpoint and is a required parameter.

Example: clt_dragonrising

deposit_urlstringOptional

The page URL where a player/user can make a monetary deposit.

Example: https://amazing-casion.com/deposit

currencystring · enumRequired

The ISO 4217 currency code. The following list contains all currencies supported by the Hub88 system. Note that native game play support with these currencies may vary per Provider.

Example: EURPossible values:

countrystring · enumRequired

The ISO 3166-1 country code, applicable to the User in the current session.

Example: EEPossible values:

Responses

200

OK

application/json

404Error

application/json

post

HTTPcURLJavaScriptPython

POST /game/url HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 346

{
  "user": "john12345",
  "token": "f562a685-a160-4d17-876d-ab3363db331c",
  "sub_partner_id": "my-casino-id",
  "platform": "GPL_DESKTOP",
  "operator_id": 1,
  "meta": {},
  "lobby_url": "https://amazing-casino.com/lobby",
  "lang": "en",
  "ip": "142.245.172.168",
  "game_code": "clt_dragonrising",
  "deposit_url": "https://amazing-casion.com/deposit",
  "currency": "EUR",
  "country": "EE"
}

{
  "url": "https://launcher.hub88.io/games/encrypted/launcher?payload=QTEyOEdDTQ.9devd1DNo9.EgnhVhHU.cV3NFgAz1xO"
}

---

Get a Game round

---

post

API to return details of a game round.

Header parameters

X-Hub88-SignatureanyRequired

RSA-SHA256 is used to sign the request body using the private key. The signature is validated using the public key associated with the provided operator_id.

Body

userstringOptional

The unique user ID in the Hub88's system. In case of DEMO gameplay, this parameter may be omitted.

Example: john12345

transaction_uuidstringOptional

The transaction identifier, which you recive from Hub88 through the API during gameplay.

Example: 16d2dcfe-b89e-11e7-854a-58404eea6d16

roundstringOptional

The round identifier, which you recive from Hub88 through the API during gameplay.

Example: rNEMwgzJAOZ6eR3V

operator_idintegerRequired

The unique identifier of Hub88 configuration in the Supplier's system used to authorize incoming requests. Could be either interger or a string.

Example: 1

Responses

200

OK

application/json

400Error

application/json

post

HTTPcURLJavaScriptPython

POST /game/round HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 121

{
  "user": "john12345",
  "transaction_uuid": "16d2dcfe-b89e-11e7-854a-58404eea6d16",
  "round": "rNEMwgzJAOZ6eR3V",
  "operator_id": 1
}

{
  "url": "https://the-best-game-provider.com/roundCheck?round=rNEMwgzJAOZ6eR3V"
}

---

Get a list of games

---

post

Returns Supplier's game list available for Hub88.

Header parameters

X-Hub88-SignatureanyRequired

RSA-SHA256 is used to sign the request body using the private key. The signature is validated using the public key associated with the provided operator_id.

Body

operator_idintegerRequired

The unique identifier of Hub88 configuration in the Supplier's system used to authorize incoming requests. Could be either interger or a string.

Example: 1

Responses

200

OK

application/json

post

HTTPcURLJavaScriptPython

POST /game/list HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 17

{
  "operator_id": 1
}

200

OK

[
  {
    "url_thumb": "https://picture-hosting.com/blackjack/thumb.png",
    "url_background": "https://picture-hosting.com/blackjack/bg.png",
    "product": "OneTouch",
    "platforms": [
      "GPL_DESKTOP",
      "GPL_MOBILE"
    ],
    "name": "Blackjack Classic",
    "game_code": "ont_blackjackclassic",
    "freebet_support": true,
    "enabled": true,
    "category": "Blackjack",
    "blocked_countries": [
      "PL",
      "BG"
    ]
  }
]