GameDealer.API
Overview
Version information
Version : V1.5
URI scheme
Host : https://whatpisangever.xyz/
BasePath : /GD.API
Schemes : HTTPS
內容
I API Overview ........................................................................................................................................................................................... 3
1. Seamless Wallet API ....................................................................................................................................................................... 3
II Seamless Wallet API ............................................................................................................................................................................. 3
2. 取得遊戲(Get Game) ...................................................................................................................................................................... 3
2.1 Open Game .................................................................................................................................................................................... 3
II.2.1.1 直接開啟遊戲不經由 Lobby ....................................................................................................................................... 4
2.2 FindGameDealerMPlayer........................................................................................................................................................ 5
III Definitions ................................................................................................................................................................................................ 7
3. Model .................................................................................................................................................................................................... 7
3.1 FindMPlayerRequestModel ................................................................................................................................................... 7
3.2 OpenGameUrlModel.................................................................................................................................................................. 7
3.3 ResettleModel .............................................................................................................................................................................. 7
3.4 APIResObj ...................................................................................................................................................................................... 7
3.5 Authenticate ................................................................................................................................................................................. 8
3.6 Bet ..................................................................................................................................................................................................... 8
3.7 AddMPlayerList .......................................................................................................................................................................... 8
IV Callback API ............................................................................................................................................................................................. 9
4. Callback API Client side need to provide below’s API for us. ................................................................................... 9
4.1 Authenticate API - https://{yourdomain}/authenticate .......................................................................................... 9
4.2 Bet API - https://{yourdomain}/bet ...............................................................................................................................10
4.3 Bet Result API - https://{yourdomain}/result ...........................................................................................................10
III.4.3.1 Modify Situation .............................................................................................................................................................10
4.4 Reverse API - https://{yourdomain}/cancel ...............................................................................................................11
I API Overview
1. Seamless Wallet API
Operator should provide the Seamless Wallet Integration API on their side. GHL Lottery will call the methods
when players make a bet or get a win and their balance should be updated.
Method Description Status
Authenticate This method authenticates player by secure
token.Casino Operator generates one-time secure
token and sends it with the URL for opening GHL
Lottery.
Required
Bet Checks if the player has enough funds and
subtracts money from player’s balance. Returns the
value of updated balance.
Required
Result Adds winning amount to player’s balance. Returns the
value of updated balance.
Required
II Seamless Wallet API
This is a simple API for Casino Operator to retrieve some data from GHL Lottery system and send some events to
GHL Lottery. API is an HTTP listener, which listens POST requests coming to an URL with the request mappings
below. All responses are in JSON format.
2. 取得遊戲(Get Game)
2.1 Open Game
開啟遊戲(obtain the open game UR)
GET /api/GameDealer/OpenGameUrl
Parameters
Type Name Description Schema
Body openGameUrl Model OpenGameUrlModel
Responses
HTTP
Description SchemaCode
200 OK object
Parameters
Name Description Schema Compulsory
APIRes 伺服器回應 APIResObj required
Rows 開啟遊戲的網址 string required
Consumes
application/json
text/json
application/xml
text/xml
application/x-www-form-urlencoded
Produces
application/json
text/json
application/xml
text/xml
II.2.1.1 直接開啟遊戲不經由 Lobby
給予 GameType LotteryTypeID 欄位
Example :
{"CompanyCode":"op5","APID":"op520250723","GameId":"12Colors","Language":"en","Technology":"H5"
,"Platform":"Web","Token":"oleidugl000hl9","GameType":"Number_Games","LotteryTypeID":"159","IsS
taging":false}
遊戲對應表 -
2.2 FindGameDealerMPlayer
查詢投注 API 使用者登入後,點擊 Bet History 會顯示己投注的
票根 (Login game in ghl web, member bet History to display
betting ticket)
POST /api/GameDealerMPlayer/FindVwGameDealerMPlayer
Parameters
Type Name Schema
Body
jo
FindMPlayerRequestModelrequired
Responses
HTTP
Description SchemaCode
200 OK object
Parameters
Name Description Schema Compulsory
APIRes 伺服器回應 (server respond) APIResObj required
Rows 查詢資料結果 (search data result) BaseObj required
List<DataObj> 回應的模型 (respond structure) GameDealerMPlayer required
Consumes
application/json
text/json
application/xml
text/xml
application/x-www-form-urlencoded
Produces
application/json
text/json
application/xml
text/xml
III Definitions
3. Model
3.1 FindMPlayerRequestModel
Name Description Schema Compulsory
CurrentPage 當下頁碼 (current page number) int optional
CurrentPeriod 期號 (sequenece number) string optional
DateE 開獎() (game opening date/time - end) DateTime(UTC +7) optional
DateS 開獎() (game opening date/time - start) DateTime(UTC +7) optional
IsWin 輸贏 (Win/lose) boolean optional
LotteryTypeID 遊戲 ID (game ID) int optional
MemberID 查詢的用戶 ID (search user ID) int optional
PageSize 一頁幾筆 (item per page) int optional
3.2 OpenGameUrlModel
Name Description Schema Compulsory
CompanyCode 公司代碼 (company code) op5 string required
APID 接口編號 op520250723 string required
Language 語系 (language) en, id, tw, cn string optional
Platform 用戶端平台(Web Moblie) (user end platform - web
or mobile) string required
Token 會員 Token (member Token) string required
IsStaging 測試帳號 boolean optional
GameId 遊戲名稱 String optional
LotteryTypeID 遊戲 ID Int optional
3.3 ResettleModel
Name Description Schema Compulsory
Id 重算單號(3.4 由我方傳入的 Id) int required
Success 是否成功(0:失敗, 1:成功) bool required
CompanyCode 公司代碼 (company code) string required
APID 接口編號 (apid) string required
3.4 APIResObj
Name Description Schema Compulsory
ResCode 伺服器結果代碼 (server result code) string required
ResMessage 伺服器結果訊息 (server result message) string required
Success 執行狀態 (operation status) boolean required
ResCode 000 is success from web api server string required
Cash 用戶餘額(User total balance) string required
3.5 Authenticate
Name Description Schema Compulsory
Token 使用者 Token string required
3.6 Bet
Name Description Schema Compulsory
UserId 使用者帳號 string required
APID 接口編號 string required
CompanyCode 公司代碼 (company code) op5 boolean required
Token 使用者 Token string required
Batch 批次(超過 20 筆會拆分成多批次呼叫) int
Bataches 總批次 Int
AddMPlayerList 注單內容 AddMPlayerList
3.7 AddMPlayerList
Name Description Schema Compulsory
ID 序號 Int required
MemberID 會員 ID Int required
LotteryInfoID 下注方式 ID Int
CompanyID 公司 ID op5 Int required
CurrentPeriod 期號 String required
LotteryInfoName 下注方式名稱 String
SelectedNums 下注號碼 String required
DiscountPrice 折扣後下注金額 String required
Price 下注金額 String required
Qty 注單數量 Int required
IsWin 是否贏錢 Boolean Required
WinMoney 贏錢金額 String Required
WinMoneyWithCapital 贏錢金額(含本金) String Required
CreateID 建立者 ID Int
CreateDate 建立時間 Datetime
UpdateID 修改者 ID Int
UpdateDate 修改時間 Datetime
LimitMin 下注金額下限 Int
LimitMax 下注金額 Int
IV Callback API
4. Callback API Client side need to provide below’s
API for us.
4.1 Authenticate API - https://{yourdomain}/authenticate
Verify third-party accounts
Request : {"token":"xxxxx"}
Response : {
"APIRes": {
"ResCode": 0,
"ResMessage": "Success",
"Success": "true"
},
"Rows": {
"UserId": " xxxxx ",
"Currency": "IDR",
"Token": " xxxxx ",
"Cash": "0.00"
}
}
4.2 Bet API - https://{yourdomain}/bet
Send bet ticket to third-party side
Reuqest :
{"userId":"ugtest_EAAAAAA0027","apid":"ugtestprod20230220","companyCode":"ugtest","token":"EAA
AAAA0027","batch":0,"total_batches":0,"addMPlayerList":[{"ID":12608242,"MemberID":2102023,"Lotter
yInfoID":428,"CompanyID":32,"CurrentPeriod":"SGP4D_0300","LotteryInfoName":"Standard_4D","Select
edNums":"1234","DiscountPrice":"340.00","Price":"1000","Qty":"1","IsWin":null, ,"WinMoney":null,"Win
MoneyWithCapital":null,,"CreateID":2102023,"CreateDate":"2023-10-
04T11:52:48.1130151+08:00","UpdateID":2102023,"UpdateDate":"2023-10-
04T11:52:48.1131007+08:00","LotteryTypeName":"4D LOTTO SINGAPOREPOOL
4D","BetAmount":null, "LimitMin":100.0,"LimitMax":100000.0}]}
Response :
{"APIRes":{"ResCode":0,"ResMessage":"Success","Success":"true"},"Rows":{"UserId":"COXGNBF056I",
"Currency":"IDR","Token":"COXGNBF056I","Cash":"8900.39"}}
4.3 Bet Result API - https://{yourdomain}/result
Reponse bet result to third-party side, if tickets more than 50, will send by batch.
( ex. Bet 100 tickets in one time, will send by follows:
1.batch:1, total_batches:2
2.batch:2, total_batches:2 )
Reuqest : {
"userId":"tml_EUGOGAA0FXZ",
"apid":"tml20210926",
"companyCode":"tml",
"token":"LoocK5ItQHA/50P6OX0RNk4bmRfCEmhE4YyTHE1smtE=",
"batch":1,
"total_batches":1,
"addMPlayerList":[{"ID":630783,"MemberID":113079,"LotteryInfoID":116,"CompanyID":7,"Curr
entPeriod":"HKP3_20220223000000","LotteryInfoName":"1st-O/E","LotteryTypeName":"HK PK10
30sec","SelectedNums":"SHUANG","IsAfter":false,"IsWinStop":false,"ManualBet":null,"Multiple":null,"D
iscountPrice":"10000","Price":"10000","Qty":"1","IsWin":false,"RebatePro":"0","RebateProMoney":"0","W
inMoney":"0.0000","IsWriteReport":false,"CreateID":113079,"CreateDate":"2022-02-
23T00:00:26.61","UpdateID":113079,"UpdateDate":"2022-02-
23T00:00:26.61",,"BetAmount":"10000","LotteryBetLimitMapID":0,"LimitMin":0.0,"LimitMax":0.0}]
}
Response : {
"ids": [
630783
],
"status": 0,
"msg": "Success"
}
III.4.3.1 Modify Situation
In live game and official lottery game, the result is input by manual, sometimes may input wrong number, will
send same data as result api, but send new WinMoney minus OriginalMoney
Ex:
Before modify is win, but after modify is lose
WinMoney=5000, WinMoneyWithCapital=10000
After modify
WinMoney=0, WinMoneyWithCapital=-5000
Request : {
"userId":"tml_2M3TNAF00NVY",
"apid":"tml20210926",
"companyCode":"tml",
"token":"2M3TNAF00NVY",
"batch":1,
"total_batches":1,
"addMPlayerList":[
{"ID":29692329, "MemberID":3997450, "LotteryInfoID":4794, "CompanyID":7,
"CurrentPeriod":"48D_20241204050108","LotteryInfoName":"Straight
Up","SelectedNums":"2","IsAfter":false, "IsWinStop":false, "ManualBet":null, "Multiple":null,
"DiscountPrice":"5000","Price":"5000","Qty":"1","IsWin":false,
"RebatePro":"0.0","RebateProMoney":null, "WinMoney":"0.0000","WinMoneyWithCapital":"-
5000.0000","IsWriteReport":false, "CreateID":3997450, "CreateDate":"2024-12-
04T05:01:53.53","UpdateID":3997450, "UpdateDate":"2024-12-
04T05:02:50.797","LotteryTypeName":"48D","UserWinMoney":0.0000,
"DrawTypeID":"214","BetAmount":"5000","LotteryBetLimitMapID":0, "LimitMin":0.0,
"LimitMax":0.0, "OriginalWinMoney":0.0000}
]
}
4.4 Reverse API - https://{yourdomain}/cancel
In live game sometimes unexpected situation happen, and period need to be canceled, will send same data as bet
api, but “IsWin = true and WinMoneyWithCapital = bet.DiscountPrice * -1 (negative DiscountPrice).
1. Number/Roulette/Sicbo Game will have recalculate data inside api request.
Reuqest :{
"userId":"ovo_HHHAABQ0LIW",
"apid":"ovo20210926",
"companyCode":"ovo",
"token":"HHHAABQ0LIW",
"batch":1,
"total_batches":1,
"addMPlayerList":[{"ID":25748996,"MemberID":3406251,"LotteryInfoID":10429,"CompanyID":1
0,"CurrentPeriod":"LSCB_20241009130736","LotteryInfoName":"2
Diff","SelectedNums":"4,6","IsAfter":false,"IsWinStop":false,"ManualBet":null,"Multiple":null,"Di
scountPrice":"15000","Price":"15000","Qty":"1","IsWin":true,"RebatePro":"0.0","RebateProMoney
":null,"WinMoney":"0","WinMoneyWithCapital":"-
15000","IsWriteReport":false,"CreateID":3406251,"CreateDate":"2024-10-
09T13:08:20.543","UpdateID":3406251,"UpdateDate":"2024-10-
09T13:08:20.543","LotteryTypeName":"Live
Sicbo","UserWinMoney":0.0,"DrawTypeID":"44","BetAmount":"15000","LotteryBetLimitMapID":
0,"LimitMin":0.0,"LimitMax":0.0,"OriginalWinMoney":0.0}]
}
Response : {
"ids": [
630783
],
"status": 0,
"msg": "Success"
}