Knowledge BaseDeveloper DocsChangelogStatusNews

Games API

Games API is the core API for using Hub88. It allows Operators to request and receive the list of available games, one singular game URL as well as a game round. All the games provided via the API are provided and implemented by Hub88.

Games API Reference

Get a Game URL

post

Returns the landing URL of the chosen game. Operator has to forward the user to the returned URL. There are several ways to forward the User: 1. Embed URL into iframe on your site; 2. Redirect User to the URL; 3. Open the URL in a 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
userstring · min: 3Required

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

Example: john12345
tokenstring · max: 255Optional

Operator's back end generates a token associated with the User, Game, player's current currency and maybe other parameters depending on the Operator's preferences. 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 or display unit, the Operator's backend needs to generate a new token and re-open the game with new token. In case of 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 Operator's sub-partner (brand, whitelabel, site, etc.) which uses same integration and credentials as an Operator. Used for detailed reporting and integration type switching. Sites under the same Operator can use different integration types: TransferWallet or SeamlessWallet. A single site (sub_partner_id) can NOT have both kinds of integration at the same time.

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

Unique identifier for the Operator in Hub88 system. Used to authorize incoming requests. You can obtain your operator_id from the Hub88 BackOffice after your Operator entity is registered and set up in the Hub88 system by the internal teams.

Example: 1
metaobjectOptional

Additional parameters which can be used for certain game Suppliers. It depends on the Operator's choice of Game Providers/Suppliers.

lobby_urlstring · max: 255Required

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_codestringRequired

The unique game identifier in Hub88 system in the form of a string. game_code can be obtained from the /game/list endpoint.

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 our system. Note that native gameplay support for these currencies may vary per Provider. Please contact us to know which Provider supports which currencies.

Example: EURPossible values:
game_currencystring · enumOptional

The ISO 4217 currency code. The following list contains all currencies supported by our 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 /operator/generic/v2/game/url HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 368

{
  "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",
  "game_currency": "EUR",
  "country": "EE"
}
{
  "url": "https://launcher.hub88.io/games/encrypted/launcher?payload=QTEyOEdDTQ.9devd1DNo9.EgnhVhHU.cV3NFgAz1xO"
}

Get a Game round

post

The endpoint allows to retrieve details of a game round. round or transaction_uuid must be passed for the request to pass.

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
userstring · min: 3Optional

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

Example: john12345
transaction_uuidstringOptional

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

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

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

Example: rNEMwgzJAOZ6eR3V
operator_idintegerRequired

Unique identifier for the Operator in Hub88 system. Used to authorize incoming requests. You can obtain your operator_id from the Hub88 BackOffice after your Operator entity is registered and set up in the Hub88 system by the internal teams.

Example: 1
Responses
200
OK
application/json
post
POST /operator/generic/v2/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 the Game List

post

Provides a list of games that are available for the Operator.

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

Unique identifier for the Operator in Hub88 system. Used to authorize incoming requests. You can obtain your operator_id from the Hub88 BackOffice after your Operator entity is registered and set up in the Hub88 system by the internal teams.

Example: 1
Responses
200
OK
application/json
post
POST /operator/generic/v2/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,
    "phoenix_jackpot_support": false,
    "enabled": true,
    "category": "Blackjack",
    "blocked_countries": [
      "PL",
      "BG"
    ],
    "release_date": "2017-11-05",
    "volatility": 1,
    "rtp": "98.8",
    "paylines": 0,
    "hit_ratio": "45.50",
    "certifications": [
      "CURACAO",
      "MGA",
      "IOM"
    ],
    "languages": [
      "eng",
      "jpn",
      "kor",
      "deu"
    ],
    "technology": [
      "HTML5"
    ],
    "features": [
      "Bonus Buy",
      "Bonus Rounds",
      "Network Jackpot",
      "In-game Jackpot"
    ]
  }
]

PreviousSeamless Wallet response statuses - Operator APINextWallet API

Last updated

Was this helpful?