Knowledge BaseDeveloper DocsProduct NewsChangelogStatusHub88 home

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
post
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
post
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
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"
    ]
  }
]

PreviousSeamless Wallet response statuses - Supplier APINextWallet API

Last updated

Was this helpful?