SoftTake API Documentation

Overview

Base URL

https://ai.cloud7hub.uk

Content-Type

application/json

This documentation is based on the SoftTake API reference provided, organized into an ergonomic format with examples, clear error handling, and copy-to-clipboard code blocks.

Authentication

All requests must include the secret-key in headers.

secret-key: YOUR_SECRET_KEY
Content-Type: application/json

1. Get Game Types

Retrieve the list of available game types and providers.

Method

GET

Endpoint

/game-service/game/types

Request

curl -X GET \
  -H "secret-key: YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  "https://ai.cloud7hub.uk/game-service/game/types"

Success Response

{
  "status": "ok",
  "data": [...],
  "errors": ""
}

Error Response

{
  "status": "failed",
  "errors": "Invalid secret key",
  "errorCode": 7004
}

2. Get Games List

Retrieve list of games for a specific game type.

Method

GET

Endpoint

/game-service/games/{game_type}

Example

/game-service/games/SL

curl -X GET \
  -H "secret-key: YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  "https://ai.cloud7hub.uk/game-service/games/SL"

Success Response

{
  "status": "ok",
  "data": [...],
  "errors": ""
}

Error Response

{
  "status": "failed",
  "errors": "Invalid g_type_code",
  "errorCode": 7014
}

3. Launch Game

Method

POST

Endpoint

/game-service/gamelaunch

Request Body

{
  "p_code": "ON",
  "g_code": "sicbo",
  "p_type": "SL",
  "username": "xxxyyy",
  "redirect_url": "https://ds.com",
  "operator": "bcon",
  "user_agent": "postman"
}

Success Response

{
  "status": "ok",
  "data": { "gameUrl": "https://..." },
  "errors": ""
}

Error Response

{
  "status": "failed",
  "errors": "Invalid secret key",
  "errorCode": 7004
}

4. Get Balance

Method

POST

Endpoint

/client-user/balance

Request Body

{
  "username": "mmmyyyy"
}

Success Response

{
  "status": "ok",
  "data": { "username": "mmmyyyy", "balance": 0.0 }
}

Error Response

{
  "status": "failed",
  "errors": "User Not Exist",
  "errorCode": 7001
}

5. Deposit

Method

POST

Endpoint

/transfer-wallet/deposit

Request Body

{
  "username": "mmmyyyy",
  "amount": 20
}

Success Response

{
  "status": "ok",
  "errorCode": 0,
  "data": { "username": "mmmyyyy", "balance": 68.0, "tx_id": "..." }
}

Error Response

{
  "status": "failed",
  "errors": "Insufficient Balance on Agent",
  "errorCode": 7008
}

6. Withdraw

Method

POST

Endpoint

/transfer-wallet/withdraw

Request Body

{
  "username": "mmmyyyy",
  "amount": 20
}

Success Response

{
  "status": "ok",
  "errorCode": 0,
  "data": { "username": "mmmyyyy", "balance": 58.0, "tx_id": "..." }
}

Error Response

{
  "status": "failed",
  "errors": "Insufficient Balance",
  "errorCode": 7012
}

7. Error Codes

Code	Description
0	Success
7001	User not exist
7002	Required parameter missing
7003	Invalid parameter
7004	Invalid secret-key
7005	Game launch exception
7006	Wrong operator
7007	Currency not matched
7008	Insufficient balance on Agent
7009	User transaction exception
7010	Agent transaction exception
7011	User balance transfer exception
7012	Insufficient balance on User
7013	Wrong p_code
7014	Wrong p_type / Invalid g_type_code