利記 API 文件

568WIN API文件

语言

中文

您的专属网域：

https://ex-api-demo-yy.568win.com/

您的专属金钥：

B8A43328C14D47E6A5F778BA576F0011

请记住您当前的网址，这是您的专属文件入口。

您的专属网域：

https://ex-api-demo-yy.568win.com/

您的专属金钥：

B8A43328C14D47E6A5F778BA576F0011

请记住你当前的网址，这是您的专属文件入口☺

1.API 概况

1.1 免责声明

请注意新加坡和台湾是禁止运营的地区。

以上述地区无法访问 568Win 的所有服务。

以下是产品地区相关的信息。

SBO 产品 - 禁止地区：新加坡、台湾、菲律宾
568win 体育 - 运营地区：仅菲律宾
其他第三方产品：请参阅第三方资讯

请注意，我方测试环境不支援压力测试，并且有调用限制。

1.2 概况

此份文件定义了接口的相关资料及平台与白牌系统的整合守则。

1.3 流程图

1.4 API 协议

所有 API接口皆透过 HTTP POST 存取。
所有 API请求应该符合以下规则
- Header:
  - Content-Type: application/json;
所有 API 回应皆是以 JSON 格式回应
所有请求和回应的数据都是区分大小写。

所有API请求和回应的时间时区都为GMT-4.

Date Only	yyyy-MM-dd
Date and Time	yyyy-MM-ddTHH:mm:ss
Date, Time and Timezone	yyyy-MM-ddTHH:mm:sszzzzzz In UTC time: 2014-08-25T11:06:22Z In GMT+8 : 2014-08-25T19:06:22+08:00 In GMT-4 : 2014-08-25T07:06:22-04:00

1.5 更新日誌

版本	调整内容
2.0.0	- 修改 7.2 重送API的参数，从ProductType(int)换成Portfolio(string)
2.1.0	- 新增游戏供应商 GiocoPlus 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.2.0	- 新增游戏供应商 EvolutionGaming 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商 - 新增附注對接Sv388Cockfighting的游戲需要對接無縫錢包的归还注额 API
2.3.0	- 移除risk-control 相關 api 說明 (該類別 Api 暫時不開放)
2.3.1	- 新增资讯於 3.8 第三方资讯(支援币别，注单相关资讯)
2.3.2	- 新增 3.3 新增"China Theme" - 調整 9.11 注单状态为实际返回值符合大小寫 - 新增游戏供应商 MicroGaming 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.3.3	- 調整3.3中SBOChina的參數命名
2.3.4	- 新增 2.1, 3.1 ErrorCode 13
2.3.5	- 新增體育報表欄位：VoidReason, 描述體育注單被退款/取消之原因
2.3.6	- 移除舊的遊戲廠商資訊 : 移除在 FlowGamingHub 裡的 MicroGaming Lobby 資訊
2.3.7	- 新增體育注單狀態 "WAITING REJECTED" - 淘汰 SeamlessGame 注單詳情的 Gametype
2.3.8	- 修復SeamlessGame注單詳情欄位屬性錯誤 - 修復第三方體育注單詳情的子注單範例錯誤 - 如果 GameIconUrl 是廠商提供完整的Url，則不添加任何domain
2.3.9	- RegisterPlayerRequestbnvi新增欄位DisplayName
2.4.0	- 增加新產品568WinSportsbook
2.4.1	- MarketType #40 標註不受bet limit影響
2.4.2	- 新增游戏供应商 MPoker 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.4.3	- 新增 3.19 Deposit 至无缝游戏提供商. - 新增 3.20 Withdraw 至无缝游戏提供商.
2.4.4	- 新增游戏供应商 YGR 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.4.5	- 移除 MarketType #40 标注不受bet limit影响的备注
2.4.6	- 勘误、优化文件
2.4.8	- (英文版)新增幣別：EUR - (中文版)補上遺失的幣別(BDT,BND,EUR)
2.4.9	- 新增游戏供应商 NineGaming, TCGaming 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.5.0	- 新增游戏供应商 AFBGaming于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.5.1	- 线上货币注单回应加上 `actualstake`, 请参考线上货币注单列表
2.5.2	- 新增游戏供应商 CQNineLC 于9.8 无缝游戏提供商
2.5.3	- 新增游戏供应商 JiLiGaming、YeeBet 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.5.4	- 新增幣別：AED, RUB, BRL, MXN - 補上遺失的幣別：UCC (USDT)
2.5.5	- 新增游戏供应商 OGLive 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.5.6	- 体育博彩注单明细新增isHalfWonLose參數
2.5.7	- 体育注单新增栏位: turnoverByStake, turnoverByActualStake, netTurnoverByStake, netTurnoverByActualStake
2.5.8	- 新增 API 8.2 获取赛事推荐 - 新增參數 3.3 导页至体育博彩
2.5.9	- 更新 9.13 无缝游戏提供商游戏种类 - 更新 8.1 錯字
2.6.0	- 调整 5.6 如果没有找到下注，将回传错误代码 6666 - 调整 5.6 文件说明关于参数 RefNos
2.6.1	- 优化中文注单传回值 betOption/sportType
2.7.0	- 新增portfolio SboLive于3.2登入
2.7.1	- 新增 3.3.2 导页至利记明星秀
2.7.2	- 新增游戏供应商 AFBCasino 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.7.3	- 新增游戏供应商 PlayTech 和 PlayTech 真人娱乐场于 9.8 无缝游戏提供商以及无缝钱包的游戏供应商.
2.8.0	- 新增 API 2.4.1 修改代理在第三方体育预设下注设定 - 新增 API 3.16.1 修改玩家在第三方体育预设下注设定 - 移除 9.12 风险控制Api错误 - 更新 9.14 第三方体育运动类型
2.8.1	- 修復 2.4.1 欄位屬性錯誤 - 修復 3.16.1 欄位屬性錯誤
2.8.2	- 新增Settle Time 于API 5.3, 5.4, 5.5, 5.6
2.8.3	- 新增游戏供应商 Rich88 真人娱乐场于 9.8 无缝游戏提供商以及无缝钱包的游戏供应商.
2.8.4	- 废弃利记明星秀相关API.
2.8.5	- 新增3.11提款使用频率的描述 - 將9.9注單列表的sportType從null改為Football
2.8.6	- 更新变数描述符合API回传以及大小写
2.8.7	- 废弃无缝钱包中小费 API
2.8.8	- 更新 3.2 登入请求之参数 - 修正英文版 8.1 游戏提供商游戏类别连结至9.13 - 更新 9.3 主题名称 SBOMain 与 SBOChina - 更新 9.7 虚拟体育盘口 - 新增游戏供应商 DreamGaming, Habanero 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商 - 更新 9.8.1 AFB Sports gameid=1
2.8.9	- 更新 9.8 无缝游戏提供商以及无缝钱包的游戏供应商新增游戏供应商 KingMaker(GPID 1033) 重命名 TwelveLive(GPID 39) -> RedTiger 重命名 NineGaming(GPID 1000) -> ArcadiaGaming 移除游戏供应商 Gamatron(GPID 41)
2.9.0	- 新增游戏供应商 568WinGaming(GPID 1029) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.9.1	- 移除游戏供应商 PlayTech(GPID 1018) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商 - 5.10 新增目前支援此API的无缝游戏厂商 EvolutionGaming
2.9.2	新增游戏供应商 AdvantPlay(GPID 1034) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.9.3	- 新增游戏游戏供应商 MicroGaming LiveCasino(GPID 1027) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商 - 新增游戏游戏供应商 RelaxGaming(GPID 1032) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商 - 新增 9.15 旧版 API
2.9.4	- 更新游戏供应商 568WinGaming(GPID 1029)名称为 568WinGames 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商 - 移除 3.19 Deposit 至无缝游戏提供商 - 移除 3.20 Withdraw 至无缝游戏提供商 - 移除 7.3 获取UM设定
2.9.5	- 新增 9.11 注单状态状态 Bonus
2.9.6	- 新增虚拟体育在 5.10 获取注单细节 - 更新虚拟体育注单列表的虚拟体育游戏产品类别 - 免转钱包中SBO產品的游戏类别取代游戏类别更新介紹更新 SBO游戏类别移除第三方游戏类别
2.9.7	- 新增 KHR
2.9.8	- 于9.8 无缝游戏提供商 ArcadiaGaming, YGR, TCGaming, AFBGaming, JiLiGaming, Rich88, 568WinGames, Habanero, RelaxGaming, KingMaker, AdvantPlay 新增大厅 - 于9.8 第三方体育提供商 Digitain 新增大厅 - 无缝钱包产品类别9忽略 game type参数
2.9.9	- 新增回应参数 "isProvideCommission" 在 8.1 获取游戏列表
2.9.10	- 新增 NGN
2.9.11	- 新增回应参数 "mainBetRef" 在 5 报表 API 的 SeamlessGame 和 9.9 无缝游戏注单列表 - 新增回应参数 "isGameProviderPromotion" 在 5 报表 API 的 SeamlessGame 和 9.9 无缝游戏注单列表 - 新增请求参数 "isGameProviderPromotion" 在无缝钱包红利 API
2.9.12	- 新增回应参数 "hasHedgeBet" 和解释在 8.1 获取游戏列表 - 下列API移除: 更新联赛群组下注设定 (API 4.4) 获取联赛群组下注设定 (API 4.5) - 下列API移除参数 "MaxBetRatio", "GroupType" APIs: 更新联赛下注设定 (API 4.2) 获取联赛下注设定 (API 4.3)
2.9.13	- 新增 TRY, PKR, LKR
2.9.14	- 5.10 移除目前支援此API的无缝游戏厂商 EvolutionGaming
2.9.15	- API 5.3, 5.4, 5.5, 5.6 的体育注单新增回应参数 "isCashOut" 解释在 9.9 注单列表的体育注单列表 - 免转钱包结算投注請求新增参数 "IsCashOut"
2.9.16	- 调整 8.2 获取赛事推荐添加供应联赛 : 欧冠杯和 E-football 取消仅返回今天比赛的限制
2.9.17	- 8.1 添加更多关于rtp, rows, lines, reels描述 - 5.10 新增支援此API的无缝游戏厂商 DreamGaming, Sv388Cockfighting, EvolutionGaming - 新增 PEN, CLP
2.9.18	新增游戏供应商 AsiaGaming(GPID 1035) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.9.19	移除支援的 9.3 主题 - China-layout-m - Euro-layout-m
2.9.20	- 新增回应参数 "NewGameType" 和解释在 8.1 获取游戏列表 - 新增附件"NewGameType" 在 9.13.1 游戏提供商新游戏类别
2.9.21	新增游戏供应商 Live22(GPID 1036) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.9.22	新增游戏供应商 WE Casino(GPID 1037) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.9.23	修正英文版API文档 [max_payout_per_match] 2.4.1 修改代理在第三方体育预设下注设定修正英文版API文档 [max_payout_per_match] 3.16.1 修改玩家在第三方体育预设下注设定
2.9.24	- 新增游戏供应商 Netent(GPID 1037) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商 - 新增游戏供应商 BigTimeGaming(GPID 1039) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商 - 新增游戏供应商 NoLimitCity(GPID 1040) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商 - 新增 COP, VES
2.9.25	- 新增游戏供应商 93connect(GPID 1041) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商 - 新增游戏供应商 PlayStar(GPID 1044) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商 - 新增游戏供应商 MikiWorld(GPID 1045) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.9.26	新增游戏供应商 KAGaming(GPID 1042) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.9.27	- 新增游戏供应商 FaChai(GPID 1046) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.9.28	- 新增游戏供应商 WCasino(GPID 1043) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.9.29	- 新增游戏供应商 PragmaticPlay (PHP)(GPID 1051) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商 - 新增游戏供应商 PragmaticPlayLiveCasino (PHP)(GPID 1052) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.9.30	修改以下描述 1.1 免责声明 3.3 导页至 SBO 体育博彩 3.4 导页至 SBO 体育博彩WAP版 3.5 导页至 568Win 真人赌场 3.6 导页至 SBO 电子游戏 3.7 导页至 SBO 虚拟体育
2.9.31	- 新增游戏供应商 GameplayLiveCasino (GPID 1048) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.9.32	- 新增游戏供应商 GameplayLottery (GPID 1049) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.9.33	- 新增游戏供应商 BoleGaming (GPID 1050) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.9.34	- 新增游戏供应商 CC88电子 (GPID 1057) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.9.35	- 修正 3.8 Login to Seamless Game 語系說明 - 更新游戏供应商 KingMaker(GPID 1033)名称为 KingMidas 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.9.36	- 新增体育供应商熊猫体育 (GPID 1053) 于9.8 无缝体育提供商以及无缝钱包的体育供应商
2.9.37	- 新增游戏供应商 LambdaGaming (GPID 1054) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.9.38	- 新增游戏供应商夺宝电子 (GPID 1058) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商 - 新增游戏供应商 Clotplay (GPID 1059) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.9.39	- 新增幣別：DZD, MAD, MNT - 新增桌面版主题 SBO Main 于9.3 主题
2.9.40	- 新增游戏供应商星球搏鸡 (GPID 1055) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.9.41	- 将代理名称允许的最大长度调整为 40。
2.9.42	- 新增游戏供应商优品电子 (GPID 1047) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商 - 新增游戏供应商天馬电子 (GPID 1060) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商 - 新增游戏供应商 ViaCasino (GPID 1064) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商 - 将 9.8.1 体育供应商熊猫体育 (GPID 1053) 大厅改为 gameid = 1
2.9.43	- 新增游戏供应商龙骑电子 (GPID 1062) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.9.44	- 新增100+币别于 9.2 币别
2.9.45	新增游戏供应商虎游 (GPID 1066) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.9.46	新增游戏供应商 BNG电子 (GPID 1067) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.9.47	新增游戏供应商 Phoenix7电子 (GPID 1056) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商新增游戏供应商 TomHorn电子 (GPID 1068) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.9.48	新增游戏供应商 WS168 鬥雞 (GPID 1070) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商新增游戏供应商 5G电子 (GPID 1071) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商新增游戏供应商 Motivation (GPID 1073) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.9.49	从游戏供应商 FlowGamingHub 移除 Netent 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.9.50	移除游戏供应商 CQNineLC (GPID 30) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商商移除游戏供应商 RedTiger (GPID 39) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商商移除游戏供应商 Sv388Cockfighting (GPID 46) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商商移除游戏供应商 GiocoPlus (GPID 47) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商商移除游戏供应商 Digitain (GPID 1011) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商商移除游戏供应商 WGBCockfighting (GPID 1055) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商商
2.9.51	新增游戏供应商 FS电子 (GPID 1079) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.9.52	新增游戏供应商 Poggi电子 (GPID 1075) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商新增游戏供应商 Aviatrix (GPID 1077) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.9.53	在SeanlessWallet Api請求中的ExtraInfo參數新增回傳winlostDate欄位
2.9.54	從568Win真人赌场移除LiveCasinoBeauty
2.9.55	新增游戏供应商 Tada电子 (GPID 1074) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.9.56	调整推荐赛事支援主题淘汰Emerald主题
2.9.57	新增请求参数 "SeamlessGameExtraInfo" 在无缝钱包扣除投注金额结算投注红利 API
2.9.58	新增游戏供应商 Spribe (GPID 1072) 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.9.59	新增报表API调用频率建议
2.9.60	新增3.18 更新会员UserGroup输入代理用户名可修改此代理之下所有玩家
2.9.61	从游戏供应商 FlowGamingHub (GPID 36) 移除 Kiron,PlayNGo,QuickSpin 于9.8 无缝游戏提供商以及无缝钱包的游戏供应商
2.9.62	9.9 注单列表, 第三方体育注单列表新增栏位 "turnoverByStake", "turnoverByActualStake", "netTurnoverByStake", "netTurnoverByActualStake"
2.9.63	添加游戏提供商信息的链接 9.8 无缝游戏提供商 9.8.1 第三方体育提供商

2.代理 API

2.1 注册代理

在白牌系统中注册代理。每个代理名称必须为唯一。

请求路径	/web-root/restricted/agent/register-agent.aspx

请求

参数	资料形态	描述 * 为必须参数
CompanyKey*	String(32)	平台和白牌系统之间的预先定义的一组私钥。
ServerId*	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
Username*	String(40)	在白牌系统中唯一的代理名称。 (只允许字母、数字及 _ )。(長度介於 6~40) 请选择安全系数更高的账号。建议您使用字母、数字和 '_' 的组合。
Password*	String(20)	代理用以登入后台的密码。(只允许字母混合数字，密码长度最少需要6个字符，且不得超过20个字符)。
Currency*	String(3)	请参考币别.
min*	Integer	该代理底下玩家的预设单笔注单最低限额。
max*	Integer	该代理底下玩家的预设单笔注单最高限额。不可超過2,000,000,000
MaxPerMatch*	Integer	该代理底下玩家的预设单场比赛最高限额。不可超過2,000,000,000
CasinoTableLimit*	Integer	该代理底下玩家的预设真人赌场限额设定。 1：低 2：中 3：高 4：VIP

回应

参数	资料形态	描述
error	ApiError	请参考API 错误.
serverId	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。

名称范例

请求

名称	范例
请求	`{ "Username": "AgentUSD01", "Password": "Test1234", "Currency": "USD", "Min": 1, "Max": 5000, "MaxPerMatch": 20000, "CasinoTableLimit": 1, "CompanyKey": "<%= CompanyKey %>", "ServerId": "YY-TEST" }`
回应	`{ "serverId": "568Win-TEST", "error": { "id": 0, "msg": "No Error" } }`

{
    "Username": "AgentUSD01",
    "Password": "Test1234",
    "Currency": "USD",
    "Min": 1,
    "Max": 5000,
    "MaxPerMatch": 20000,
    "CasinoTableLimit": 1,
    "CompanyKey": "<%= CompanyKey %>",
    "ServerId": "YY-TEST"
}

回应

{
    "serverId": "568Win-TEST",
    "error": {
    "id": 0,
    "msg": "No Error"
    }
}

2.2 更新代理状态

更新代理状态至 CLOSED / SUSPEND / ACTIVE.
若更新状态为 CLOSED, 该代理底下的玩家将无法登入。若更新状态为 SUSPEND, 该代理底下的玩家可以登入，但无法下注。代理状态更新的影响会马上生效。

请求路径	/web-root/restricted/agent/update-agent-status.aspx

请求

参数	资料形态	描述 * 为必须参数
CompanyKey*	String(32)	平台和白牌系统之间的预先定义的一组私钥。
ServerId*	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
Username*	String(40)	在白牌系统中唯一的代理名称。 (只允许字母、数字及 _ )。(長度介於 6-40)
Status*	String	Active / Suspend / Closed .

回应

参数	资料形态	描述
error	ApiError	请参考API 错误.
serverId	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。

名称	范例
请求	`{ "Username": "AgentUSD01", "Status": "Active", "CompanyKey": "<%= CompanyKey %>", "ServerId": "YY-TEST" }`
回应	`{ "serverId": "568Win-TEST", "error": { "id": 0, "msg": "No Error" } }`

2.3 修改代理预设下注设定

在白牌系统中更新代理预设下注设定。单场比赛最高限额必须大于等于单笔注单最高限额，且单笔注单最高限额必须大于等于单笔注单最低限额。此修改会套用在未来新注册的玩家，并不会对既有玩家产生影响，

请求路径	/web-root/restricted/agent/update-agent-preset-bet-settings.aspx

请求

平台和白牌系统之间的预先定义的一组私钥。

参数	资料形态	描述 * 为必须参数
CompanyKey*	String(32)	平台和白牌系统之间的预先定义的一组私钥。
ServerId*	String(15)
Username*	String(40)	在白牌系统中唯一的代理名称。 (只允许字母、数字及 _ )。(長度介於 6-40)
min*	Integer	该代理底下玩家的预设单笔注单最低限额
max*	Integer	该代理底下玩家的预设单笔注单最高限额。不可超過2,000,000,000
MaxPerMatch*	Integer	该代理底下玩家的预设单场比赛最高限额。不可超過2,000,000,000
CasinoTableLimit*	Integer	该代理底下玩家的预设真人赌场限额设定。 1：低 2：中 3：高 4：VIP

回应

参数	资料形态	描述
error	ApiError	请参考API 错误.
serverId	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。

名称范例

请求

名称	范例
请求	`{ "Username": "AgentUSD01", "Min": 2, "Max": 4000, "MaxPerMatch": 60000, "CasinoTableLimit": 4, "CompanyKey": "<%= CompanyKey %>", "ServerId": "YY-TEST" }`
回应	`{ "serverId": "568Win-TEST", "error": { "id": 0, "msg": "No Error" } }`

{
    "Username": "AgentUSD01",
    "Min": 2,
    "Max": 4000,
    "MaxPerMatch": 60000,
    "CasinoTableLimit": 4,
    "CompanyKey": "<%= CompanyKey %>",
    "ServerId": "YY-TEST"
}

回应

{
    "serverId": "568Win-TEST",
    "error": {
    "id": 0,
    "msg": "No Error"
    }
}

2.4 根据运动与盘口修改代理预设下注设定

根据运动与盘口在白牌系统中更新代理预设下注设定。单场比赛最高限额必须大于等于单笔注单最高限额，且单笔注单最高限额必须大于等于单笔注单最低限额。此修改会套用在未来新注册的玩家，并不会对既有玩家产生影响，

请求路径	/web-root/restricted/agent/update-agent-preset-bet-setting-by-sportid-and-markettype.aspx

请求

参数

资料形态

描述 * 为必须参数

CompanyKey*

String(32)

平台和白牌系统之间的预先定义的一组私钥。

ServerId*

String(15)

自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。

Username*

String(40)

在白牌系统中唯一的代理名称。 (只允许字母、数字及 _ )。(長度介於 6-40)

BetSettings*

BetSetting

代理投注设置.

sport_type*	Integer	请参考运动类型运动类型.
market_type*	Integer	请参考市场类型市场类型.
min_bet*	Integer	预设最小赌注.
max_bet*	Integer	预设最大赌注.
max_bet_per_match*	Integer	预设每场比赛的最大赌注.

回应

参数	资料形态	描述
Error	ApiError	请参考API 错误.
ServerId	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。

名称范例

请求

名称	范例
请求	`{ "Username": "AgentUSD01", "BetSettings": [ { "sport_type": 0, "market_type": 0, "min_bet": 1, "max_bet": 500, "max_bet_per_match": 1000 }, { "sport_type": 1, "market_type": 1, "min_bet": 2, "max_bet": 300, "max_bet_per_match": 800 } ], "CompanyKey": "<%= CompanyKey %>", "ServerId": "YY-TEST" }`
回应	`{ "serverId": "568Win-TEST", "error": { "id": 0, "msg": "No Error" } }`

{
                    "Username": "AgentUSD01",
                    "BetSettings": [
                    {
                        "sport_type": 0,
                        "market_type": 0,
                        "min_bet": 1,
                        "max_bet": 500,
                        "max_bet_per_match": 1000
                    },
                    {
                        "sport_type": 1,
                        "market_type": 1,
                        "min_bet": 2,
                        "max_bet": 300,
                        "max_bet_per_match": 800
                    }
                  ],
                    "CompanyKey": "<%= CompanyKey %>",
                    "ServerId": "YY-TEST"
                }

回应

{
                    "serverId": "568Win-TEST",
                    "error": {
                        "id": 0,
                        "msg": "No Error"
                    }
                }

2.4.1 修改代理在第三方体育预设下注设定

请求路径	/web-root/restricted/agent/update-agent-preset-seamlessgameprovider-sports-bet-setting-by-sports-type.aspx

请求

参数

资料形态

描述 * 为必须参数

GameProviderId*

String(32)

请参考游戏提供商 ID
目前僅支援 SABA 第三方體育廠商

CompanyKey*

String(32)

平台和白牌系统之间的预先定义的一组私钥。

ServerId*

String(15)

自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。

Username*

String(40)

在白牌系统中唯一的代理名称。 (只允许字母、数字及 _ )。(長度介於 6-40)

BetSettings*

BetSetting

下注设定代理下的新玩家

sport_type*	String	请参考运动类型.
min_bet*	Integer	下注最低限额
max_bet*	Integer	下注最高限额
max_bet_per_match*	Integer	per match 下注最高限额
max_payout_per_match*	Integer	per match Payout最高限额

限额参数请参考第三方限额表

回应

参数	资料形态	描述
error	ApiError	请参考API 错误.
serverId	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。

名称范例

请求

名称	范例
请求	`{ "GameProviderId": 1, "Username": "AgentUSD01", "BetSettings": [ { "sport_type": "0", "min_bet": 1, "max_bet": 500, "max_bet_per_match": 1000, "max_payout_per_match": 2000 }, { "sport_type": "1", "min_bet": 2, "max_bet": 300, "max_bet_per_match": 800, "max_payout_per_match": 1600 } ], "CompanyKey": "<%= CompanyKey %>", "ServerId": "YY-TEST" }`
回应	`{ "serverId": "568Win-TEST", "error": { "id": 0, "msg": "No Error" } }`

                                    
  {
      "GameProviderId": 1,
      "Username": "AgentUSD01",
      "BetSettings": [
          {
              "sport_type": "0",
              "min_bet": 1,
              "max_bet": 500,
              "max_bet_per_match": 1000,
              "max_payout_per_match": 2000
          },
          {
              "sport_type": "1",
              "min_bet": 2,
              "max_bet": 300,
              "max_bet_per_match": 800,
              "max_payout_per_match": 1600
          }
      ],
      "CompanyKey": "<%= CompanyKey %>",
      "ServerId": "YY-TEST"
  }

回应

{
                                        "serverId": "568Win-TEST",
                                        "error": {
                                        "id": 0,
                                        "msg": "No Error"
                                        }
                                    }

3.会员 API

3.1 注册会员

在白牌系统注册会员. 每个会员都必须归属在一个代理下，会员层级为公司 -> 代理 -> 会员. 新会员的默认TableLimit为其代理的TableLimit设定。

请求路径	/web-root/restricted/player/register-player.aspx

请求

参数	资料形态	描述 * 为必须参数
CompanyKey*	String(32)	平台和白牌系统之间的预先定义的一组私钥。
ServerId*	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
Username*	String(40)	在白牌系统中唯一的会员名称。 (只允许字母、数字及 _ )。(長度介於 6-40)
Agent*	String(40)	在白牌系统中唯一的代理名称。 (只允许字母、数字及 _ )。(長度介於 6-40)
UserGroup	String(1)	設定的UserGroup。可能值為 'a','b','c','d','e','f'.
DisplayName	String(500)	玩家的顯示名稱。

回应

参数	资料形态	描述
error	ApiError	请参考API 错误.
serverId	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。

名称范例

请求

名称	范例
请求	`{ "Username" : "TestPlayer002", "Agent" : "AgentUSD01", "UserGroup": "a", "CompanyKey": "<%= CompanyKey %>", "ServerId": "YY-TEST" }`
回应	`{ "serverId": "YY-staging", "error": { "id": 0, "msg": "No Error" } }`

{
    "Username" : "TestPlayer002",
    "Agent" : "AgentUSD01",
      "UserGroup": "a",
    "CompanyKey": "<%= CompanyKey %>",
    "ServerId": "YY-TEST"
}

回应

{
    "serverId": "YY-staging",
    "error": {
    "id": 0,
    "msg": "No Error"
    }
}

呼叫此函式能够得到登入URL来登入白牌系统。回应中的URL是这次登入session的一次性密码，并且会在20秒内失效。玩家在登入时，白牌系统会验证这个URL。客户端可以利用这个URL将玩家导到白牌系统的入口。以体育为例 : https://{sportsbook-domain} , 拿到入口链结后，实际上串接的入口链结为https://{sportsbook-domain}/welcome2.aspx?token=token&lang=en&oddstyle=MY&theme=black&oddsmode=double&device=d

请求路径	/web-root/restricted/player/login.aspx

参数	资料形态	描述 * 为必须参数
CompanyKey*	String(32)	平台和白牌系统之间的预先定义的一组私钥。
ServerId*	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
Username*	String(40)	在白牌系统中唯一的会员名称。 (只允许字母、数字及 _ )。(長度介於 6-40)
Portfolio*	String(20)	SportsBook / Casino / Games / VirtualSports / SeamlessGame / ThirdPartySportsBook / 568WinSportsbook
IsWapSports	Boolean	欲登入低流量版本球板使用, 预设值为 false, 如欲登入低流量版本，请输入值为 true

参数	资料形态	描述
url	String	登入游戏用的URL
serverId	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
error	ApiError	请参考API 错误.

名称范例

请求

名称	范例
请求	`{ "Username" : "TestPlayer002", "Portfolio" : "SportsBook", "IsWapSports": false, "CompanyKey": "<%= CompanyKey %>", "ServerId": "YY-TEST" }`
回应	`{ "url": "sports-test.mydomain.com/welcome2.aspx?token=15433.sWRjsIETIDMjlZVTnzdQMNpV", "serverId": "YY-staging", "error": { "id": 0, "msg": "No Error" } }`


    {
    "Username" : "TestPlayer002",
    "Portfolio" : "SportsBook",
    "IsWapSports": false,
    "CompanyKey": "<%= CompanyKey %>",
    "ServerId": "YY-TEST"
    }

回应

{
    "url": "sports-test.mydomain.com/welcome2.aspx?token=15433.sWRjsIETIDMjlZVTnzdQMNpV",
    "serverId": "YY-staging",
    "error": {
    "id": 0,
    "msg": "No Error"
    }
}

接收到登入API的回应后，将玩家导至体育博彩的入口。

名称	范例
Url*	https://{response-url}&lang=en&oddstyle=MY&theme=SboMain&oddsmode=double&device=d ※{response-url} 從Login Api取得
lang*	请参考Language.
oddstyle*	`MY : Malay odds (default) HK : HongKong odds EU : Euro odds ID : Indonesia odds`
theme*	如果想要置换视觉主题，于URL加入&theme=black，"black"可依照下列视觉主题置换预设视觉主题SboMain. ※theme將會存在Cookie中,若您發現使用theme參數主題並沒有改變,請嘗試清除Cookie並再試一次※ 请参考Themes。请注意此设定仅影响体育博彩，不影响真人赌场与电子游戏。
oddsmode*	double (default) / single
device*	'd' => desktop (default) 'm' => mobile
recommendmatchid	自动导向至推荐赛事。请参考 API 8.2 获取赛事推荐的MatchId 目前僅支援SBO(桌机、手机)主题和SBOMain(手机)主题

接收到登入API的回应后，将玩家导至体育博彩的入口。

名称	范例
Url*	https://{response-url}&lang=en&oddstyle=MY&oddsmode=double&device=d ※{response-url} 從Login Api取得
lang*	请参考Language.
oddstyle*	`MY : Malay odds (default) HK : HongKong odds EU : Euro odds ID : Indonesia odds`
oddsmode*	double (default) / single
device*	'd' => desktop (default) 'm' => mobile

接收到登入API的回应后，将玩家导至体育博彩WAP版的入口。

名称	范例
Url*	https://{response-url}&lang=en&oddstyle=MY ※{response-url} 從Login Api取得
lang*	请参考Language.
oddstyle*	`MY : Malay odds (default) HK : HongKong odds EU : Euro odds ID : Indonesia odds`

接收到登入API的回应后，将玩家导至真人赌场的入口。

名称

范例

Url*

https://{response-url}&locale=en&device=d&productId=3
※{response-url} 從Login Api取得

locale*

语言请参考Language.

device*

'd' => desktop
'm' => mobile

productId

Product ID	Game Name
0(default)	lobby
1	Baccarat
3	Roulette
5	SicBo
9	DragonTiger
10	MultipleTableBaccarat
12	SpeedBaccarat

接收到登入API的回应后，将玩家导至电子游戏的入口。

名称

范例

Url*

https://{response-url}&gameId=6101
※{response-url} 從Login Api取得

gameId*

Game IDs of game entries are as followed:
                                    
                                    
                                    
                                    Game ID
                                    Game Name
                                    Device
                                                            
                                                        
                                    
                                    
                                    6101
                                    皇家百家乐
                                    桌机
                                                            
                                    
                                    6102
                                    皇家轮盘
                                    桌机
                                                        
                                    
                                    6103
                                    皇家骰宝
                                    桌机
                                                        
                                    
                                    6104
                                    皇家21点
                                    桌机
                                                        
                                    
                                    6105
                                    皇家多手21点
                                    桌机
                                                        
                                    
                                    6106
                                    龙宝
                                    桌机
                                                        
                                    
                                    604501
                                    Money Roll
                                    桌机
                                                        
                                    
                                    602801
                                    皇家百家乐
                                    手机
                                                        
                                    
                                    602802
                                    皇家轮盘
                                    手机
                                                        
                                    
                                    602803
                                    皇家骰宝
                                    手机
                                                        
                                    
                                    602804
                                    皇家21点
                                    手机
                                                        
                                    
                                    602805
                                    皇家多手21点
                                    手机
                                                        
                                    
                                    602811
                                    龙宝
                                    手机
                                                        
                                    
                                    604501
                                    Money Roll
                                    手机
                                                        
                                    
                                    610001
                                    活力宾果!!
                                    Desktop

接收到登入API的回应后，将玩家导至虚拟体育的入口。
*提醒: 程式将自动侦测使用者的装置(桌上型电脑/手机)，并提供对应网页版本。

名称	范例
Url*	https://{response-url}&lang=en ※{response-url} 從Login Api取得
lang*	*Supported language : en => English (default) zh-tw => Traditional Chinese zh-cn => Simplify Chinese id-id => Indo th-th => Thai

接收到登入API的回应后，将玩家导至无缝游戏的入口。

名称	范例
Url*	https://{response-url}&gpid=10000&gameid=0&lang=en&device=d&betCode=5CNY2050000_5CNY10200000 ※{response-url} 從Login Api取得
lang*	*Supported language : en => English (default) zh-tw => Traditional Chinese zh-cn => Simplify Chinese 更多详细资讯，请参考第三方支持语言
gpId/gameId*	* gpid : 此參數代表玩家要到哪個遊戲提供商的遊戲 * gameid: 此參數代表登入後要到哪個遊戲或是大廳 * gameid and gpid 请参考第三方游戏资讯. * 如果gameid与gpid没有输入参数，将会导到预设页面：游戏大厅 * 我们诚挚的建议您方使用我司所提供的“游戏大厅”或“Casino大厅”。 * 我司连同所有其他游戏皆包含在“游戏大厅”及“Casino大厅”中,助于提升玩家游玩体验 * GAMES LOBBY => gpId:10000 gameId:0 * CASINO LOBBY => gpId:10000 gameId:1
device*	'd' => desktop 'm' => mobile
betCode	此参数代表可以调整第三方游戏的限额在登入前, 如需设定多個限额, 请使用"_"作区分, 参数请参考第三方限额表

請參考這份文件: 第三方资讯(支援币别，注单相关资讯)

接收到登入API的回应后，将玩家导至第三方体育的入口。

名称	范例
Url*	https://{response-url}&gpid=10000&gameid=0&lang=en&device=d ※{response-url} 從Login Api取得
lang*	*Supported language : en => English (default) zh-tw => Traditional Chinese zh-cn => Simplify Chinese id-id => Indo th-th => Thai
gpId/gameId*	* gpid : 此參數代表玩家要到哪個遊戲提供商的遊戲 * gameid: 此參數代表登入後要到哪個遊戲或是大廳 * gameid and gpid 请参考Third Party Sportsbook Providers.
device*	'd' => desktop 'm' => mobile

3.9 更新会员状态

更新会员状态至 CLOSED / SUSPEND / ACTIVE.
若更新状态为 CLOSED, 该会员将无法登入，并将会被踢出系统。若更新状态为 SUSPEND, 该会员可以登入，但无法下注。会员状态更新的影响会马上生效。

请求路径	/web-root/restricted/player/update-player-status.aspx

请求

参数	资料形态	描述 * 为必须参数
CompanyKey*	String(32)	平台和白牌系统之间的预先定义的一组私钥。
ServerId*	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
Username*	String(40)	在白牌系统中唯一的会员名称。 (只允许字母、数字及 _ )。(長度介於 6-40)
Status*	String	Active / Suspend / Closed .

回应

参数	资料形态	描述
error	ApiError	请参考API 错误.
serverId	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。

名称	范例
请求	`{ "Username" : "TestPlayer002", "Status" : "CLOSED", "CompanyKey": "<%= CompanyKey %>", "ServerId": "YY-TEST" }`
回应	`{ "serverId": "YY-staging", "error": { "id": 0, "msg": "No Error" } }`

3.10 会员存款

呼叫此函式可以将钱从平台存入白牌系统。白牌系统只允许玩家以注册时输入的币别存入白牌系统。
交易单号(transaction id)为平台产生用以识别该次交易。参考单号(Reference no)为白牌系统产生并用以识别该次交易。
交易单号和参考单号是一对一匹配的。每个请求的交易单号必须为唯一，任何带着重复交易单号的请求都会回传错误(请求失败)。

请求路径	/web-root/restricted/player/deposit.aspx

请求

参数	资料形态	描述 * 为必须参数
CompanyKey*	String(32)	平台和白牌系统之间的预先定义的一组私钥。
ServerId*	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
Username*	String(40)	在白牌系统中唯一的会员名称。 (只允许字母、数字及 _ )。(長度介於 6-40)
Amount*	Decimal	只允许正数。(仅支援到小数点后第二位)
txnId*	String(30)	平台产生的识别Id，在平台中所有交易Id（包含提款/存款）为唯一值。

回应

参数	资料形态	描述
error	ApiError	请参考API 错误.
serverId	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
txnId	String(30)	平台产生的识别Id，在平台中所有交易Id（包含提款/存款）为唯一值。
refNo	String(100)	白牌系统内该笔注单的参考单号
balance	Decimal	该会员的现金余额，它还需要减去未结算投注才会是会员的真正余额。
outstanding	Decimal	未结算投注。

名称范例

请求

名称	范例
请求	`{ "Username": "TestPlayer002", "TxnId": "D20190208190823090", "Amount": 8947, "CompanyKey": "<%= CompanyKey %>", "ServerId": "YY-TEST" }`
回应	`{ "txnId": "D20190208190823090", "refno": "ApiD20191118063732207", "balance": 8947, "outstanding": 0, "serverId": "YY-staging", "error": { "id": 0, "msg": "No Error" } }`

{
    "Username": "TestPlayer002",
    "TxnId": "D20190208190823090",
    "Amount": 8947,
    "CompanyKey": "<%= CompanyKey %>",
    "ServerId": "YY-TEST"
}

回应

{
    "txnId": "D20190208190823090",
    "refno": "ApiD20191118063732207",
    "balance": 8947,
    "outstanding": 0,
    "serverId": "YY-staging",
    "error": {
    "id": 0,
    "msg": "No Error"
    }
}

3.11 会员提款

呼叫此函式可以将钱从白牌系统提出至平台。
白牌系统只允许会员以注册时输入的币别存入白牌系统。
交易单号(transaction id)为平台产生用以识别该次交易。
参考单号(Reference no)为白牌系统产生并用以识别该次交易。
交易单号和参考单号是一对一匹配的。每个请求的交易单号必须为唯一，任何带着重复交易单号的请求都会回传错误(请求失败)。玩家只允许提出可用余额。
如果还有未结算的下注，玩家只能在该笔下注结算后才能提出该笔下注的款项。
会员提出的金额支援到两位小数，若超过限制，将会回报错误,
范例:合法请求格式: 19.42; 非法请求格式: 19.4297。
每笔提款需间隔5秒

请求路径	/web-root/restricted/player/withdraw.aspx

请求

参数	资料形态	描述 * 为必须参数
CompanyKey*	String(32)	平台和白牌系统之间的预先定义的一组私钥。
ServerId*	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
Username*	String(40)	在白牌系统中唯一的会员名称。 (只允许字母、数字及 _ )。(長度介於 6-40)
Amount*	Decimal	只允许正数。(至多两位小数)
txnId*	String(30)	由平台产生的识别Id，在平台中所有交易Id（包含提款/存款）为唯一值。
IsFullAmount*	Boolean	若isFullAmount = true ，则所有允许提出可用余额将被提取若isFullAmount = false，则request中的amount余额将被提取

回应

参数	资料形态	描述
error	ApiError	请参考API 错误.
serverId	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
amount	Decimal	提款金额
txnId	String(30)	由平台产生的识别Id，在平台中所有交易Id（包含提款/存款）为唯一值。
refNo	String(100)	白牌系统内该笔注单的参考单号
balance	Decimal	该会员的现金余额，它还需要减去未结算投注才会是会员的真正余额。
outstanding	Decimal	未结算投注

名称范例

请求

{
    "Username": "TestPlayer002",
    "txnId": "W0128012380",
    "IsFullAmount": true,
    "Amount": 0,
    "CompanyKey": "<%= CompanyKey %>",
    "ServerId": "YY-TEST"
}

回应

{
    "amount": 8947,
    "txnId": "W0128012380",
    "refno": "ApiW20191118064204053",
    "balance": 0,
    "outstanding": 0,
    "serverId": "YY-staging",
    "error": {
    "id": 0,
    "msg": "No Error"
    }
}

3.12 查询存提款交易状态

利用此API查询交易状态

请求路径	/web-root/restricted/player/check-transaction-status.aspx

请求

参数	资料形态	描述 * 为必须参数
CompanyKey*	String(32)	平台和白牌系统之间的预先定义的一组私钥。
ServerId*	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
txnId*	String(30)	由平台产生的识别Id，在平台中所有交易Id（包含提款/存款）为唯一值。

回应

参数	资料形态	描述
error	ApiError	请参考API 错误.
serverId	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
transactionType	String	withdraw/ deposit
amount	Decimal	此次交易的金额
txnId	String(30)	由平台产生的识别Id，在平台中所有交易Id（包含提款/存款）为唯一值。
refNo	String(100)	白牌系统内该笔注单的参考单号

名称范例

请求

{
    "TxnId": "W0128012380",
    "CompanyKey": "<%= CompanyKey %>",
    "ServerId": "YY-TEST"
}

回应

{
    "amount": 8947,
    "txnId": "W0128012380",
    "refno": "ApiW20191118064204053",
    "transactionType": "withdraw",
    "serverId": "YY-staging",
    "error": {
    "id": 0,
    "msg": "No Error"
    }
}

3.13 获取会员余额

利用此API获取会员在白牌系统的余额。

请求路径	/web-root/restricted/player/get-player-balance.aspx

请求

参数	资料形态	描述 * 为必须参数
CompanyKey*	String(32)	平台和白牌系统之间的预先定义的一组私钥。
ServerId*	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
Username*	String(40)	在白牌系统中唯一的会员名称。 (只允许字母、数字及 _ )。(長度介於 6-40)

回应

参数	资料形态	描述
error	ApiError	请参考API 错误.
serverId	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
username	String(40)	在白牌系统中唯一的会员名称。 (只允许字母、数字及 _ )。(長度介於 6-40)
currency	String(3)	会员在白牌系统的币别。
balance	Decimal	该会员的余额，它还需要减去未结算投注才会是会员的真正余额。
outstanding	Decimal	未结算投注

名称范例

请求

{
    "Username": "TestPlayer002",
    "CompanyKey": "<%= CompanyKey %>",
    "ServerId": "YY-TEST"
}

回应

{
    "username": "TestPlayer002",
    "currency": "USD",
    "balance": 0,
    "outstanding": 0,
    "serverId": "YY-staging",
    "error": {
    "id": 0,
    "msg": "No Error"
    }
}

3.14 登出会员

如果会员还在线，呼叫此函式可以登出会员，并清除该会员的Session。(游玩SBO产品的玩家将会被登出)

请求路径	/web-root/restricted/player/logout.aspx

请求

参数	资料形态	描述 * 为必须参数
CompanyKey*	String(32)	平台和白牌系统之间的预先定义的一组私钥。
ServerId*	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
Username*	String(40)	在白牌系统中唯一的会员名称。 (只允许字母、数字及 _ )。(長度介於 6-40)

回应

参数	资料形态	描述
error	ApiError	请参考API 错误.
serverId	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。

名称	范例
请求	`{ "Username": "TestPlayer002", "CompanyKey": "<%= CompanyKey %>", "ServerId": "YY-TEST" }`
回应	`{ "serverId": "YY-staging", "error": { "id": 0, "msg": "No Error" } }`

3.15 更新会员下注设定

呼叫此函式可以更新会员在白牌系统的下注设定。单场比赛最高限额必须大于等于单笔注单最高限额，且单笔注单最高限额必须大于等于单笔注单最低限额。

请求路径	/web-root/restricted/player/update-player-bet-settings.aspx

请求

参数	资料形态	描述 * 为必须参数
CompanyKey*	String(32)	平台和白牌系统之间的预先定义的一组私钥。
ServerId*	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
Username*	String(40)	在白牌系统中唯一的会员名称。 (只允许字母、数字及 _ )。(長度介於 6-40)
min*	Integer	该会员单笔注单最低限额
max*	Integer	该会员单笔注单最高限额。不可超過2,000,000,000
MaxPerMatch*	Integer	该会员单场比赛最高限额。不可超過2,000,000,000
CasinoTableLimit*	Integer	该会员真人赌场下注设定。 1：低 2：中 3：高 4：VIP

回应

参数	资料形态	描述
error	ApiError	请参考API 错误.
serverId	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。

名称范例

请求

{
    "Username": "TestPlayer002",
    "Min": 5,
    "Max": 100,
    "MaxPerMatch": 2000,
    "CasinoTableLimit": 4,
    "CompanyKey": "<%= CompanyKey %>",
    "ServerId": "YY-TEST"
}

回应

{
    "serverId": "YY-staging",
    "error": {
    "id": 0,
    "msg": "No Error"
    }
}

3.16 根据运动以及盘口更新会员在白牌系统的下注设定。

呼叫此函式可以更新会员在白牌系统的下注设定。
单场比赛最高限额必须大于等于单笔注单最高限额，且单笔注单最高限额必须大于等于单笔注单最低限额。
输入代理名称会更新该代理下的下注设定。该更新立即生效。
此下注设定并不会套用到未来新注册的玩家。

请求路径	/web-root/restricted/player/update-player-bet-setting-by-sportid-and-markettype.aspx

请求

参数

资料形态

描述 * 为必须参数

CompanyKey*

String(32)

平台和白牌系统之间的预先定义的一组私钥。

ServerId*

String(15)

自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。

Username*

String(40)

在白牌系统中唯一的代理/会员名称。 (只允许字母、数字及 _ )。(長度介於 6-40)

BetSettings*

Object

参数	资料形态	描述
sport_type	Integer	运动类型的Id, 请参考运动类型
market_type	Integer	盘口的Id, 请参考盘口
min_bet	Integer	单笔注单最低限额
max_bet	Integer	单笔注单最高限额
max_bet_per_match	Integer	单场比赛最高限额

回应

参数	资料形态	描述
error	ApiError	请参考API 错误.
serverId	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。

名称范例

请求

{
    "Username": "TestPlayer002",
    "BetSettings": [
    {
        "sport_type": 0,
        "market_type": 0,
        "min_bet": 1,
        "max_bet": 500,
        "max_bet_per_match": 1000
    },
    {
        "sport_type": 1,
        "market_type": 1,
        "min_bet": 2,
        "max_bet": 300,
        "max_bet_per_match": 800
    }
  ],
    "CompanyKey": "<%= CompanyKey %>",
    "ServerId": "YY-TEST"
}

回应

{
    "serverId": "YY-staging",
    "error": {
    "id": 0,
    "msg": "No Error"
    }
}

3.16.1 修改玩家在第三方体育预设下注设定

呼叫此函式可以更新会员在第三方体育的下注设定。
单场比赛最高限额必须大于等于单笔注单最高限额，且单笔注单最高限额必须大于等于单笔注单最低限额。
此下注设定并不会套用到未来新注册的玩家。

请求路径	/web-root/restricted/player/update-player-seamlessgameprovider-sports-bet-setting-by-sport-type.aspx

请求

参数

资料形态

描述 * 为必须参数

GameProviderId*

String(32)

请参考游戏提供商 ID
目前僅支援 SABA 第三方體育廠商

CompanyKey*

String(32)

平台和白牌系统之间的预先定义的一组私钥。

ServerId*

String(15)

自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。

Username*

String(40)

在白牌系统中唯一的玩家名称。 (只允许字母、数字及 _ )。(長度介於 6-40) 如输入代理名称，则会设定代理下的全部玩家。

BetSettings*

BetSetting

下注设定代理下的新玩家

sport_type*	String	请参考运动类型.
min_bet*	Integer	下注最低限额
max_bet*	Integer	下注最高限额
max_bet_per_match*	Integer	per match 下注最高限额
max_payout_per_match*	Integer	per match Payout最高限额

限额参数请参考第三方限额表

回应

参数	资料形态	描述
error	ApiError	请参考API 错误.
serverId	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。

名称范例

请求

                                    
 {
     "GameProviderId": 1,
     "Username": "PlayerUSD01",
     "BetSettings": [
         {
             "sport_type": "0",
             "min_bet": 1,
             "max_bet": 500,
             "max_bet_per_match": 1000,
             "max_payout_per_match": 2000
         },
         {
             "sport_type": "1",
             "min_bet": 2,
             "max_bet": 300,
             "max_bet_per_match": 800,
             "max_payout_per_match": 1600
         }
     ],
     "CompanyKey": "<%= CompanyKey %>",
     "ServerId": "YY-TEST"
 }

回应

                                    
                                        {
                                            "serverId": "568Win-TEST",
                                            "error": {
                                            "id": 0,
                                            "msg": "No Error"
                                            }
                                        }

3.17 根据运动类型和盘口获取会员的下注设定

根据运动类型和盘口获取会员在白牌系统的下注设定

请求路径	/web-root/restricted/player/get-member-bet-settings-with-sportid-and-markettype.aspx

请求

参数	资料形态	描述 * 为必须参数
CompanyKey*	String(32)	平台和白牌系统之间的预先定义的一组私钥。
ServerId*	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
Username*	String(40)	在白牌系统中唯一的玩家/代理名称。 (只允许字母、数字及 _ )。(長度介於 6-40)

回应

参数

资料形态

描述

Error

ApiError

请参考API 错误.

ServerId

String(15)

自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。

username*

String(40)

在白牌系统中唯一的玩家名称。 (只允许字母、数字及 _ )。(長度介於 6-40)

betSettings

Object

参数	资料形态	描述
sport_type	Integer	运动类型的Id, 请参考运动类型.
market_type	Integer	盘口的Id, 请参考盘口.
min_bet	decimal	单笔注单最低限额
max_bet	decimal	单笔注单最高限额
max_bet_per_match	decimal	单场比赛最高限额

名称范例

请求

{
        "Username": "TestPlayer002",
        "CompanyKey": "<%= CompanyKey %>",
        "ServerId": "YY-TEST"
    }

回应

{
        "username": "TestPlayer002",
        "betSettings": [
            {
                "sport_type": 0,
                "market_type": 0,
                "min_bet": 1,
                "max_bet": 500,
                "max_bet_per_match": 1000
            },
            {
                "sport_type": 1,
                "market_type": 1,
                "min_bet": 2,
                "max_bet": 300,
                "max_bet_per_match": 800
            }
        ],
        "serverId": "YY-staging",
        "error": {
        "id": 0,
        "msg": "No Error"
        }
    }

3.18 更新会员UserGroup

更新会员UserGroup(A,B,C,D,E,F)

请求路径	/web-root/restricted/player/update-player-usergroup.aspx

请求

参数	资料形态	描述 * 为必须参数
CompanyKey*	String(32)	平台和白牌系统之间的预先定义的一组私钥。
ServerId*	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
Username*	String(40)	在白牌系统中唯一的会员名称。 (只允许字母、数字及 _ )。(長度介於 6-40) 输入代理用户名可修改此代理之下所有玩家的 UserGroup，但不影响新註册之玩家
PlayerUserGroup*	String(1)	会员的新UserGroup (A,B,C,D,E,F)。

回应

参数	资料形态	描述
error	ApiError	请参考API 错误.
serverId	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。

名称	范例
请求	`{ "Username": "TestPlayer002", "CompanyKey": "<%= CompanyKey %>", "ServerId": "YY-TEST", "PlayerUserGroup": "c" }`
回应	`{ "serverId": "YY-staging", "error": { "id": 0, "msg": "No Error" } }`

4.联赛 API

4.1 获取联赛Id与名称

呼叫此API可以获取联赛代码与名称
呼叫此API时请不要把SportType设置成0

请求路径	/web-root/restricted/league/get-league.aspx

请求

参数	资料形态	描述 * 为必须参数
CompanyKey*	String(32)	平台和白牌系统之间的预先定义的一组私钥。
ServerId*	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
LeagueNameKeyWord*	String(20)	联赛名称关键字
SportType*	Integer	请参考运动类型(这支api请勿以0作为输入)
FromDate*	DateTime	联赛下赛事的起始日期
ToDate*	DateTime	联赛下赛事的结束日期

回应

参数

资料形态

描述

error

ApiError

请参考API 错误.

serverId

String(15)

自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。

result

Object

参数	资料形态	描述
league_id	Integer	联赛Id
league_name	String(100)	联赛名称

名称范例

请求

{
    "LeagueNameKeyWord": "cup",
    "FromDate": "2019-11-01 00:00:00",
    "ToDate": "2019-11-11 00:00:00",
    "SportType":1,
    "CompanyKey": "<%= CompanyKey %>",
    "ServerId": "YY-TEST"
}

回应

{
    "result": [
        {
            "league_id": 55,
            "league_name": "Scotland League Cup"
        },
        {
            "league_id": 76,
            "league_name": "Sweden Cup"
        },
        {
            "league_id": 110,
            "league_name": "Denmark Cup"
        }
    ],
    "serverId": "YY-staging",
    "error": {
    "id": 0,
    "msg": "No Error"
    }
}

4.2 更新联赛下注设定

呼叫此API可以通过联赛Id，币别，赛事是否滚球来设定修改联赛下注设定

请求路径	/web-root/restricted/league/set-league-bet-setting.aspx

请求

参数	资料形态	描述 * 为必须参数
CompanyKey*	String(32)	平台和白牌系统之间的预先定义的一组私钥。
ServerId*	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
LeagueId*	Integer	联赛Id
Currency*	String(3)	请参考币别.
IsLive*	Boolean	此联赛下是否为滚球的赛事
MinBet*	Integer	该联赛之下的赛事单笔注单最低限额
MaxBet*	Integer	该联赛之下的赛事单笔注单最高限额

回应

参数	资料形态	描述
error	ApiError	请参考API 错误.
serverId	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。

名称范例

请求

{
    "LeagueId": 1,
    "Currency": "USD",
    "IsLive": true,
    "MinBet": 5,
    "MaxBet": 800,
    "CompanyKey": "<%= CompanyKey %>",
    "ServerId": "YY-TEST"
}

回应

{
    "serverId": "YY-staging",
    "error": {
    "id": 0,
    "msg": "No Error"
    }
}

4.3 获取联赛下注设定

呼叫此API可以通过联赛Id，币别，赛事是否滚球来获取联赛下注设定

请求路径	/web-root/restricted/league/get-league-bet-setting.aspx

请求

参数	资料形态	描述 * 为必须参数
CompanyKey*	String(32)	平台和白牌系统之间的预先定义的一组私钥。
ServerId*	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
LeagueId*	Integer	联赛Id
Currency*	String(3)	请参考币别.
IsLive*	Boolean	是否为滚球

回应

参数

资料形态

描述

error

ApiError

请参考API 错误.

serverId

String(15)

自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。

result

Object

参数	资料形态	描述
league_id	Integer	联赛Id
currency	String(3)	请参考币别.
is_live	Bool	是否为滚球
min_bet	decimal	单笔注单最低限额
max_bet	decimal	单笔注单最高限额

名称范例

请求

{
    "LeagueId": 1,
    "Currency": "USD",
    "IsLive": true,
    "CompanyKey": "<%= CompanyKey %>",
    "ServerId": "YY-TEST"
}

回应

{
    "result": [
        {
            "league_id": 1,
            "currency": "USD",
            "is_live": true,
            "min_bet": 10,
            "max_bet": 1000
        }
    ],
    "serverId": "YY-staging",
    "error": {
    "id": 0,
    "msg": "No Error"
    }
}

5.报表 API

5.1 根据输赢日期获取客户报表

若提供的使用者名称为代理名称，该次请求会回传所有该代理下的会员的报表。
若提供的使用者名称为会员名称，则该次请求回传该会员的报表。
此请求中的日期参数应基于WinLostDate。
API调用频率建议：每个玩家、每个类别每天一次，时间范围为一天。
资料的搜索范围必须是在60天以内。

请求路径	/web-root/restricted/report/get-customer-report-by-win-lost-date.aspx

请求

参数	资料形态	描述 * 为必须参数
companyKey*	String(32)	平台和白牌系统之间的预先定义的一组私钥。
serverId*	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
username*	String(40)	在白牌系统中唯一的代理/会员名称。 (只允许字母、数字及 _ )。(長度介於 6-40)
portfolio*	String(20)	SportsBook / Casino / Games / VirtualSports / SeamlessGame / ThirdPartySportsBook / 568WinSportsbook
startDate*	DateTime	起始输赢日期
endDate*	DateTime	结束输赢日期

回应

参数资料形态描述

error ApiError 请参考API 错误.

serverId String(15) 自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。

result

Object

参数	资料形态	描述
username	String(40)	白牌系统内的会员名称
betcount	Object	根据注单状态归类出注单量。当该状态注单量>0时才会显示。举例：会员有两笔注单为输，一笔为和。 `"betCount": { "lose": 2, "draw":1 }`
turnover	Object	根据注单状态归类出注单流水量(turnover)。当该状态注单流水量>0时才会显示。举例：会员有注单为输的流水为765，注单为赢流水为192。 `"turnover": { "lose": 765, "win":192 }`
winlost	decimal	玩家的注单净赢
commission	decimal	会员Commission
totalDeposit	decimal	会员总存款金额
totalWithdrawal	decimal	会员总提款金额

名称范例

请求

{
    "username": "TestPlayer002",
    "portfolio": "VirtualSports",
    "startDate": "2019-11-10T03:18:43.540Z",
    "endDate": "2019-11-20T03:18:43.540Z",
    "companyKey": "<%= CompanyKey %>",
    "serverId": "YY-TEST"
}

回应

{
  "result": [
    {
      "username": "TestPlayer002",
      "betCount": {
        "lose": 2
      },
      "turnover": {
        "lose": 560.88
      },
      "winlost": 0,
      "commission": 0,
      "totalDeposit": 6600,
      "totalWithdrawal": 5609.5
    }
  ],
  "serverId": "YY-staging",
  "error": {
    "id": 0,
    "msg": "No Error"
  }
}

5.2 根据修改日期获取客户报表

若提供的使用者名称为代理名称，该次请求会回传所有该代理下的会员的报表。
若提供的使用者名称为会员名称，则该次请求回传该会员的报表。
此请求中的日期参数应基于ModifyDate。
API调用频率建议：每个玩家、每个类别每10分钟一次，时间范围为10分钟。
资料的搜索范围必须是在60天以内。

请求路径	/web-root/restricted/report/get-customer-report-by-modify-date.aspx

请求

参数	资料形态	描述 * 为必须参数
companyKey*	String(32)	平台和白牌系统之间的预先定义的一组私钥。
serverId*	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
username*	String(40)	在白牌系统中唯一的代理/会员名称。 (只允许字母、数字及 _ )。(長度介於 6-40)
portfolio*	String(20)	SportsBook / Casino / Games / VirtualSports / SeamlessGame / ThirdPartySportsBook / 568WinSportsbook
startDate*	DateTime	起始修改日期
endDate*	DateTime	结束修改日期

回应

参数资料形态描述

error ApiError 请参考API 错误.

serverId String(15) 自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。

result

Object

参数	资料形态	描述
username	String(40)	白牌系统内的会员名称
betcount	Object	根据注单状态归类出注单量。当该状态注单量>0时才会显示。举例：会员有两笔注单为输，一笔为和。 `"betCount": { "lose": 2, "draw":1 }`
turnover	Object	根据注单状态归类出注单流水量(turnover)。当该状态注单流水量>0时才会显示。举例：会员有注单为输的流水为765，注单为赢流水为192。 `"turnover": { "lose": 765, "win":192 }`
winlost	decimal	玩家的注单净赢
commission	decimal	会员Commission
totalDeposit	decimal	会员总存款金额
totalWithdrawal	decimal	会员总提款金额

名称范例

请求

{
    "username": "TestPlayer002",
    "portfolio": "VirtualSports",
    "startDate": "2019-11-10T03:18:43.540Z",
    "endDate": "2019-11-20T03:18:43.540Z",
    "companyKey": "<%= CompanyKey %>",
    "serverId": "YY-TEST"
}

回应

{
  "result": [
    {
      "username": "TestPlayer002",
      "betCount": {
        "lose": 2
      },
      "turnover": {
        "lose": 560.88
      },
      "winlost": 0,
      "commission": 0,
      "totalDeposit": 6600,
      "totalWithdrawal": 5609.5
    }
  ],
  "serverId": "YY-staging",
  "error": {
    "id": 0,
    "msg": "No Error"
  }
}

5.3 根据修改日期获取注单列表

此API会回传特定会员/特定代理下的所有会员在该时间区间内的注单列表。
API调用频率建议：每个玩家、每个类别每10分钟一次，时间范围为10分钟。
资料的搜索范围必须是在60天以内。

请求路径	/web-root/restricted/report/get-bet-list-by-modify-date.aspx

请求

参数	资料形态	描述 * 为必须参数
companyKey*	String(32)	平台和白牌系统之间的预先定义的一组私钥。
serverId*	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
username*	String(40)	在白牌系统中唯一的代理名称。 (只允许字母、数字及 _ )。(長度介於 6-40)
portfolio*	String(20)	SportsBook / Casino / Games / VirtualSports / SeamlessGame / ThirdPartySportsBook / 568WinSportsbook
startDate*	DateTime	起始修改时间
endDate*	DateTime	结束修改时间
language	String	语言，目前仅有体育注单提供中文(zh-cn)翻译，預設為英文(en)

回应

参数	资料形态	描述
error	ApiError	请参考API 错误.
serverId	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
result	Object	请参考注单列表。

名称范例

请求

   {
    "username": "player0330",
    "portfolio": "SportsBook",
    "startDate": "2020-01-29T06:39:59.931Z",
    "endDate": "2020-06-29T06:39:59.931Z",
    "companyKey": "<%= CompanyKey %>",
    "language": "en",
    "serverId": "YY-TEST"
    }

回应

{
  "result": [
    {
      "subBet": [
        {
          "betOption": "e-Leicester City",
          "marketType": "Handicap",
          "hdp": 0,
          "odds": -3.12,
          "league": "e-Football Elite Club Friendly",
          "match": "e-Leicester City vs e-Watford",
          "status": "draw",
          "winlostDate": "2020-05-18T00:00:00",
          "liveScore": "0:0",
          "htScore": "0:0",
          "ftScore": "0:0",
          "customeizedBetType": "",
          "kickOffTime": "0001-01-01T00:00:00"
        }
      ],
      "refNo": "4000011",
      "username": "player0330",
      "sportsType": "Football",
      "orderTime": "2020-05-18T04:28:56.73",
      "winLostDate": "2020-05-18T00:00:00",
      "settleTime": "2020-05-18T04:43:30.827",
      "modifyDate": "2020-05-18T04:43:30.827",
      "odds": -3.12,
      "oddsStyle": "I",
      "stake": 10,
      "actualStake": 31.2,
      "currency": "IDR",
      "status": "draw",
      "winLost": 0,
      "turnover": 10,
      "turnoverByStake": 10,
      "turnoverByActualStake": 31.2,
      "netTurnoverByStake": 0,
      "netTurnoverByActualStake": 0,
      "isHalfWonLose": false,
      "isCashOut": false,
      "isLive": true,
      "maxWinWithoutActualStake": 10,
      "ip": "203.176.129.999",
      "voidReason": "RiskControl-CR"
    },
    {
      "subBet": [
        {
          "betOption": "1",
          "marketType": "1X2",
          "hdp": 0,
          "odds": 15.5,
          "league": "e-Football Elite Club Friendly",
          "match": "e-Manchester City vs e-Piemonte Calcio",
          "status": "lose",
          "winlostDate": "2020-05-18T00:00:00",
          "liveScore": "0:1",
          "htScore": "0:1",
          "ftScore": "0:2",
          "customeizedBetType": "",
                    "kickOffTime": "0001-01-01T00:00:00",
                    "isHalfWonLose": false
        }
      ],
      "refNo": "4000013",
      "username": "player0330",
      "sportsType": "Football",
      "orderTime": "2020-05-18T04:30:54.587",
      "winLostDate": "2020-05-18T00:00:00",
      "modifyDate": "2020-05-18T04:44:20.853",
      "settleTime": "2020-05-18T04:44:20.853",
      "odds": 15.5,
      "oddsStyle": "E",
      "stake": 7,
      "actualStake": 7,
      "currency": "IDR",
      "status": "lose",
      "winLost": -7,
      "turnover": 7,
      "turnoverByStake": 7,
      "turnoverByActualStake": 7,
      "netTurnoverByStake": 7,
      "netTurnoverByActualStake": 7,
      "isHalfWonLose": false,
      "isLive": true,
      "maxWinWithoutActualStake": 101,
      "ip": "203.176.129.999"
    }
  ],
  "serverId": "YY-staging",
  "error": {
    "id": 0,
    "msg": "No Error"
  }
}

5.4 根据修改日期获取注单列表(无须会员名)

此API会回传所有会员在该时间区间内的注单列表。
API调用频率建议：每个类别每30秒一次，时间范围为1分钟。
资料的搜索范围必须是在60天以内。
修改时间区间需小于或等于30分鐘。

请求路径	/web-root/restricted/report/v2/get-bet-list-by-modify-date.aspx

请求

参数	资料形态	描述 * 为必须参数
companyKey*	String(32)	平台和白牌系统之间的预先定义的一组私钥。
serverId*	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
portfolio*	String(20)	SportsBook / Casino / Games / VirtualSports / SeamlessGame / ThirdPartySportsBook / 568WinSportsbook
startDate*	DateTime	起始修改时间
endDate*	DateTime	结束修改时间
language	String	语言，目前仅有体育注单提供中文(zh-cn)翻译，預設為英文(en)
isGetDownline	Bool	是否包括下綫的注單

回应

参数	资料形态	描述
error	ApiError	请参考API 错误.
serverId	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
result	Object	请参考注单列表。

名称范例

请求


{
    "portfolio": "SportsBook",
    "startDate": "2019-03-24T07:12:43.807Z",
    "endDate": "2020-03-24T07:12:43.807Z",
    "companyKey": "<%= CompanyKey %>",
    "isGetDownline": true,
    "language": "en",
    "serverId": "YY-TEST"
}

回应


 {
    "result": [
        {
            "subBet": [
                {
                    "betOption": "Hyderabad FC (R)",
                    "marketType": "Handicap",
                    "hdp": -0.25,
                    "odds": -0.87,
                    "league": "India 2nd Division League",
                    "match": "Hyderabad FC (R) vs Bengaluru FC (R)",
                    "status": "lose",
                    "winlostDate": "2020-03-12T00:00:00",
                    "liveScore": "0:0",
                    "htScore": "0:0",
                    "ftScore": "0:1",
                    "customeizedBetType": "",
                    "kickOffTime": "0001-01-01T00:00:00",
                    "isHalfWonLose": false
                }
            ],
            "refNo": "4000289",
            "username": "p0312",
            "sportsType": "Football",
            "orderTime": "2020-03-12T06:47:32.297",
            "winLostDate": "2020-03-12T00:00:00",
            "settleTime": "2020-03-12T07:57:22.52",
            "modifyDate": "2020-03-12T07:57:22.52",
            "odds": -0.87,
            "oddsStyle": "M",
            "stake": 8,
            "actualStake": 6.96,
            "currency": "TMP",
            "status": "lose",
            "winLost": -6.96,
            "turnover": 8,
            "turnoverByStake": 8,
            "turnoverByActualStake": 6.96,
            "netTurnoverByStake": 8,
            "netTurnoverByActualStake": 6.96,
            "isHalfWonLose": false,
            "isCashOut": false,
            "isLive": true,
            "maxWinWithoutActualStake": 8,
            "topDownline": "YourApiDownline",
            "ip": "string",
            "voidReason": "RiskControl-CR"
        },
        {
            "subBet": [
                {
                    "betOption": "Gremio Porto Alegre",
                    "marketType": "Handicap",
                    "hdp": 0,
                    "odds": 0.6,
                    "league": "COPA LIBERTADORES",
                    "match": "Gremio Porto Alegre vs Internacional RS",
                    "status": "draw",
                    "winlostDate": "2020-03-12T00:00:00",
                    "liveScore": "0:0",
                    "htScore": "0:0",
                    "ftScore": "0:0",
                    "customeizedBetType": "",
                    "kickOffTime": "0001-01-01T00:00:00",
                    "isHalfWonLose": false
                }
            ],
            "refNo": "4000338",
            "username": "p0312",
            "sportsType": "Football",
            "orderTime": "2020-03-12T21:44:42.677",
            "winLostDate": "2020-03-12T00:00:00",
            "settleTime": "2020-03-12T22:08:58.507",
            "modifyDate": "2020-03-12T22:08:58.507",
            "odds": 0.6,
            "oddsStyle": "M",
            "stake": 10,
            "actualStake": 10,
            "currency": "TMP",
            "status": "draw",
            "winLost": 0,
            "turnover": 10,
            "turnoverByStake": 10,
            "turnoverByActualStake": 10,
            "netTurnoverByStake": 0,
            "netTurnoverByActualStake": 0,
            "isHalfWonLose": false,
            "isLive": true,
            "maxWinWithoutActualStake": 6,
            "topDownline": "YourApiDownline",
            "ip": "string"
        }
    ],
    "serverId": "YY-demoanduat",
    "error": {
        "id": 0,
        "msg": "No Error"
    }
}

5.5 根据交易日期获取注单列表

请求路径	/web-root/restricted/report/get-bet-list-by-transaction-date.aspx

请求

参数	资料形态	描述 * 为必须参数
companyKey*	String(32)	平台和白牌系统之间的预先定义的一组私钥。
serverId*	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
username*	String(40)	在白牌系统中唯一的代理/会员名称。 (只允许字母、数字及 _ )。(長度介於 6-40)
portfolio*	String(20)	SportsBook / Casino / Games / VirtualSports / SeamlessGame / ThirdPartySportsBook / 568WinSportsbook
startDate*	DateTime	起始交易时间
endDate*	DateTime	结束交易时间
language	String	语言，目前仅有体育注单提供中文(zh-cn)翻译，預設為英文(en)

回应

参数	资料形态	描述
error	ApiError	请参考API 错误.
serverId	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
result	Object	请参考注单列表。

名称范例

请求

 {
    "username": "player0330",
    "portfolio": "SportsBook",
    "startDate": "2020-01-29T06:39:59.931Z",
    "endDate": "2020-06-29T06:39:59.931Z",
    "language": "en",
    "companyKey": "<%= CompanyKey %>",
    "serverId": "YY-TEST"
    }

回应

{
  "result": [
    {
      "subBet": [
        {
          "betOption": "e-Leicester City",
          "marketType": "Handicap",
          "hdp": 0,
          "odds": -3.12,
          "league": "e-Football Elite Club Friendly",
          "match": "e-Leicester City vs e-Watford",
          "status": "draw",
          "winlostDate": "2020-05-18T00:00:00",
          "liveScore": "0:0",
          "htScore": "0:0",
          "ftScore": "0:0",
          "customeizedBetType": "",
                    "kickOffTime": "0001-01-01T00:00:00",
                    "isHalfWonLose": false
        }
      ],
      "refNo": "4000011",
      "username": "player0330",
      "sportsType": "Football",
      "orderTime": "2020-05-18T04:28:56.73",
      "winLostDate": "2020-05-18T00:00:00",
      "settleTime": "2020-05-18T04:43:30.827",
      "modifyDate": "2020-05-18T04:43:30.827",
      "odds": -3.12,
      "oddsStyle": "I",
      "stake": 10,
      "actualStake": 31.2,
      "currency": "IDR",
      "status": "draw",
      "winLost": 0,
      "turnover": 10,
      "turnoverByStake": 10,
      "turnoverByActualStake": 31.2,
      "netTurnoverByStake": 0,
      "netTurnoverByActualStake": 0,
      "isHalfWonLose": false,
      "isCashOut": false,
      "isLive": true,
      "maxWinWithoutActualStake": 10,
      "ip": "203.176.129.999",
      "voidReason": "RiskControl-CR"
    },
    {
      "subBet": [
        {
          "betOption": "1",
          "marketType": "1X2",
          "hdp": 0,
          "odds": 15.5,
          "league": "e-Football Elite Club Friendly",
          "match": "e-Manchester City vs e-Piemonte Calcio",
          "status": "lose",
          "winlostDate": "2020-05-18T00:00:00",
          "liveScore": "0:1",
          "htScore": "0:1",
          "ftScore": "0:2",
          "customeizedBetType": "",
                    "kickOffTime": "0001-01-01T00:00:00",
                    "isHalfWonLose": false
        }
      ],
      "refNo": "4000013",
      "username": "player0330",
      "sportsType": "Football",
      "orderTime": "2020-05-18T04:30:54.587",
      "winLostDate": "2020-05-18T00:00:00",
      "settleTime": "2020-05-18T04:43:30.827",
      "modifyDate": "2020-05-18T04:44:20.853",
      "odds": 15.5,
      "oddsStyle": "E",
      "stake": 7,
      "actualStake": 7,
      "currency": "IDR",
      "status": "lose",
      "winLost": -7,
      "turnover": 7,
      "turnoverByStake": 7,
      "turnoverByActualStake": 7,
      "netTurnoverByStake": 7,
      "netTurnoverByActualStake": 7,
      "isHalfWonLose": false,
      "isLive": true,
      "maxWinWithoutActualStake": 101,
      "ip": "203.176.129."
    }
  ],
  "serverId": "YY-staging",
  "error": {
    "id": 0,
    "msg": "No Error"
  }
}

5.6 根据交易编号取得注单列表

This function will get the bet list by using RefNos.
API调用频率建议：每个类别每30秒一次。
资料的搜索范围必须是在60天以内。

请求路径	/web-root/restricted/report/get-bet-list-by-refnos.aspx

请求

参数	资料形态	描述 * 为必须参数
companyKey*	String(32)	平台和白牌系统之间的预先定义的一组私钥。
serverId*	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
refNos*	String(1000)	在白牌系统内每笔注单有唯一的交易编号用以识别，可输入多笔并以逗号隔开。
portfolio*	String(20)	SportsBook / Casino / Games / VirtualSports / SeamlessGame / ThirdPartySportsBook / 568WinSportsbook
language	String	语言，目前仅有体育注单提供中文(zh-cn)翻译，預設為英文(en)

回应

参数	资料形态	描述
error	ApiError	请参考API 错误.
serverId	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
result	Object	请参考注单列表。

名称范例

请求


    {
    "refNos": "V2671814",
    "portfolio": "VirtualSports",
    "companyKey": "<%= CompanyKey %>",
    "language": "en",
    "serverId": "YY-TEST"
    }

回应

{
    "result": [
        {
            "orderTime": "2020-03-12T22:58:45.447",
            "modifyDate": "2020-03-12T23:03:08.32",
            "settleTime": "2020-03-12T23:03:08.32",
            "refNo": "V2671814",
            "username": "p0312",
            "gameId": 2671814,
            "odds": 16.728,
            "oddsStyle": "Euro",
            "stake": 1.000000,
            "actualStake": 1.000000,
            "turnover": 1.000000,
            "winLost": -1.000000,
            "status": "lose",
            "productType": "MixParlayDesktop",
            "subBet": [
                {
                    "htScore": "1:0",
                    "ftScore": "3:0",
                    "betOption": "Over",
                    "marketType": "FirstHalfOverUnder",
                    "hdp": "2.5",
                    "odds": 3.400,
                    "match": "Season 15743 / Match Day 13",
                    "status": "Lose",
                    "winLostDate": "2020-03-13T00:00:00"
                },
                {
                    "htScore": "0:0",
                    "ftScore": "1:0",
                    "betOption": "VL Vienna",
                    "marketType": "FirstHalfAsianHandicap",
                    "hdp": "-0.25",
                    "odds": 2.050,
                    "match": "Season 15743 / Match Day 13",
                    "status": "Won",
                    "winLostDate": "2020-03-13T00:00:00"
                },
                {
                    "htScore": "2:1",
                    "ftScore": "3:2",
                    "betOption": "VL Copenhagen",
                    "marketType": "FirstHalfOneXTwo",
                    "hdp": "",
                    "odds": 2.400,
                    "match": "Season 15743 / Match Day 13",
                    "status": "Lose",
                    "winLostDate": "2020-03-13T00:00:00"
                }
            ]
        }
    ],
    "serverId": "YY-demoanduat",
    "error": {
        "id": 0,
        "msg": "No Error"
    }
}

5.7 获取会员交易报表

获取特定会员的交易报表(存款/提款)
API调用频率建议：每个玩家每10分钟一次，时间范围为10分钟。

请求路径	/web-root/restricted/report/get-customer-transaction.aspx

请求

参数	资料形态	描述 * 为必须参数
companyKey*	String(32)	平台和白牌系统之间的预先定义的一组私钥。
serverId*	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
username*	String(40)	在白牌系统中唯一的会员名称。 (只允许字母、数字及 _ )。(長度介於 6-40)
startDate*	DateTime	起始交易日期
endDate*	DateTime	结束交易日期

回应

参数

资料形态

描述

error

ApiError

请参考API 错误.

serverId

String(15)

自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。

result

Object

参数	资料形态	描述
txnId	String(30)	由平台产生的识别Id，在平台中所有交易Id（包含提款/存款）为唯一值。
transDate	DateTime	交易日期
username	String(40)	白牌系统内的会员名称
agentName	String(40)	该会员在白牌系统内的代理名称
currency	String(3)	请参考币别.
refNo	String(100)	白牌系统内该笔交易的参考单号
transactionType	String	withdraw/ deposit
amount	Decimal	存/提款金额

名称范例

请求

{
    "username": "TestPlayer002",
    "startDate": "2019-11-10T03:18:43.559Z",
    "endDate": "2019-11-21T03:18:43.559Z",
    "companyKey": "<%= CompanyKey %>",
    "serverId": "YY-TEST"
}

回应

{
  "result": [
    {
      "txnId": "TestPlayer002Deposit1",
      "transDate": "2019-11-15T06:01:45.52",
      "username": "TestPlayer002",
      "agentName": "TestAgent002",
      "currency": "USD",
      "refNo": "ApiD20191115060145517",
      "transactionType": "Deposit",
      "amount": 5000
    },
    {
      "txnId": "Ds123123",
      "transDate": "2019-11-18T06:37:32.207",
      "username": "TestPlayer002",
      "agentName": "TestAgent002",
      "currency": "USD",
      "refNo": "ApiD20191118063732207",
      "transactionType": "Deposit",
      "amount": 600
    }
  ],
  "serverId": "YY-staging",
  "error": {
    "id": 0,
    "msg": "No Error"
  }
}

5.8 取得体育Forecast页面链接

调用此接口取得体育Forecast页面链接。

请求路径	/web-root/restricted/report/v2/get-forecast-page.aspx

请求

参数	资料形态	描述 * 为必须参数
CompanyKey*	String(32)	平台和白牌系统之间的预先定义的一组私钥。
ServerId*	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。

回应

参数	资料形态	描述
url*	String	回传之服务链接
error	ApiError	请参考API 错误.
serverId	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。

名称范例

请求

{
    "CompanyKey": "<%= CompanyKey %>",
    "ServerId": "YY-TEST"
}

回应

{
    "url": "https://admin.sswwkk.com/welcome.aspx?token=18.ccLYkGNnRHMWELROvZxpZICiT&toUrl=Forecast&lang=en&isGetAll=0&webId=1",
    "serverId": "YY-staging",
    "error": {
    "id": 0,
    "msg": "No Error"
    }
}

5.9 取得体育Last50页面链接

调用此接口取得体育Last50页面链接。

请求路径	/web-root/restricted/report/v2/get-last50-page.aspx

请求

参数	资料形态	描述 * 为必须参数
CompanyKey*	String(32)	平台和白牌系统之间的预先定义的一组私钥。
ServerId*	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。

回应

参数	资料形态	描述
url*	String	回传之服务链接
serverId	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
error	ApiError	请参考API 错误.

名称范例

请求

{
    "CompanyKey": "<%= CompanyKey %>",
    "ServerId": "YY-TEST"
}

回应

{
    "url": "https://admin.sswwkk.com/welcome.aspx?token=18.YlHLiSjbLtWTiqALPBpuWq&toUrl=Last50&lang=en&isGetAll=0&webId=1",
    "serverId": "YY-staging",
    "error": {
    "id": 0,
    "msg": "No Error"
    }
}

5.10 获取注单细节

透过呼叫此API来获取体育博彩、真人赌场、电子游戏、虚拟体育或无缝游戏的注单细节链结。
目前支援此API的无缝游戏厂商 : GameProvider Information

URL	/web-root/restricted/report/get-bet-payload.aspx

请求

参数	资料形态	描述 * 为必须参数
CompanyKey*	String(32)	平台和白牌系统之间的预先定义的一组私钥。
ServerId*	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
Portfolio*	String(15)	预设为Casino，查询的产品类别，可输入SportsBook / Casino / Games / VirtualSports / SeamlessGame / 568WinSportsbook
Refno*	String(20)	注单的单号。
Language	String(20)	语言预设为 EN, 其他可输入的值为 ZH_TW, ZH_CN, JA_JP, KO_KR, TH_TH VI_VN。 (此项设定只有部分无缝游戏会生效)(Yggdrasil只支持EN)

回应

参数	资料形态	描述
url*	String	回传之服务链接
error	ApiError	请参考API 错误.
serverId	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。

名称范例

请求


{
    "CompanyKey": "<%= CompanyKey %>",
    "ServerId": "YY-TEST",
    "Portfolio" : "casino",
    "Refno" : "B001183631498",
    "Language" : "en"
}

回应


{
  "url": "https://lobby-winfast888.wecname.com/web-root/public/dispatch.aspx?payload=GYopCUkIUt%2bILIPWGo3VsHqeWykir4RBooc93WkIwk3dqkUXtjVfDMuzWDq2Hep1J58t9owE7MPX7D2eI9dka2EN7q8bwcACmEnLn0LnewOvjy01LcXXYaogJqptoas%2b5QOrn17ihU4A9MF%2bUIWK5Q%3d%3d",
  "serverId": "YY-demoanduat",
  "error": {
    "id": 0,
    "msg": "No Error"
  }
}

7.系统 API

7.1 Ping

检查白牌系统是否能够正常存取

请求路径	/web-root/restricted/system/ping.aspx

请求

参数	资料形态	描述 * 为必须参数
CompanyKey*	String(32)	平台和白牌系统之间的预先定义的一组私钥。
ServerId*	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。

回应

参数	资料形态	描述
error	ApiError	请参考API 错误.
serverId	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。

名称	范例
请求	`{ "CompanyKey": "<%= CompanyKey %>", "ServerId": "YY-TEST" }`
回应	`{ "serverId": "YY-staging", "error": { "id": 0, "msg": "No Error" } }`

7.2 重送注单

重送四天内无缝钱包已结算注单或已取消注单，可输入多个单号，用逗号切开。

请求路径	/web-root/restricted/seamless-wallet/resend-order

请求

参数	资料形态	描述 * 为必须参数
companyKey*	String(32)	平台和白牌系统之间的预先定义的一组私钥。
serverId*	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
txnId*	String(100)	重送標的的注單單號，每個注單單號請用逗號隔開。
portfolio*	String(20)	SportsBook / Casino / Games / VirtualSports / SeamlessGame / ThirdPartySportsBook

回应

参数	资料形态	描述
error	ApiError	请参考API 错误.
serverId	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。

名称	范例
请求	`{ "txnId": "2319512,2319513", "portfolio": "SportsBook", "companyKey": "<%= CompanyKey %>", "serverId": "YY-TEST" }`
回应	`{ "serverId": "YY-staging", "error": { "id": 0, "msg": "No Error" } }`

8.信息 API

8.1 获取游戏列表

此功能可获取所有可玩的游戏

URL	/web-root/restricted/information/get-game-list.aspx

请求

参数	资料形态	描述 * 为必须参数
CompanyKey*	String(32)	平台和白牌系统之间的预先定义的一组私钥。
ServerId*	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
GpId*	Integer	游戏提供商的序号，请参考游戏提供商
IsGetAll*	Boolean	无视GpId取得所有游戏内容。

回应

参数	资料形态	描述
Seamless GameProvider Games	list	無縫GameProvider遊戲.
gameProviderId	int	游戏提供商编号
gameId	int	游戏编号
gameType	string	该参数已停止维护，请使用newGameType代替
newgameType	string	新游戏类别，请参考游戏提供商游戏类别注意，如果游戏类型为100或200，则表示赌场或游戏大厅。您可以通过相对应的游戏ID进入游戏大厅。由于新游戏类别的分类比较完善，我们建议使用此参数，而不是使用上方的旧参数。
rank	int	游戏排名。值越小，排名越高。
device	String	桌面版，行动版或全部 ('d':桌面版, 'm':行动版, 'd,m': 全部)
platform	String	HTML5 或 Flash
provider	string	供应商名称。有子供应商会是子供应商名称。
rtp	decimal	游戏的玩家回报率，若厂商未提供相关参数，则会显示 -1
rows	int	老虎机游戏的行数，若厂商未提供相关参数，则会显示 -1
reels	int	老虎机游戏的列数，若厂商未提供相关参数，则会显示 -1
lines	int	老虎机游戏的最大连线数，若厂商未提供相关参数，则会显示 -1
gameInfos	list	游戏资讯。
language	string	游戏语言。
gameName	string	游戏名称。
gameIconUrl	string	游戏图标链接。
supportedCurrencies	String[]	请参考币别。
blockCountries	String[]	请参考地区。
isMaintain	boolean	游戏是否正在维修
isEnabled	boolean	是否启用
error	ApiError	错误。请参考Api错误.
serverId	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
isProvideCommission	boolean	是否有提供Commission
hasHedgeBet	boolean	是否可以对押。例如在百家乐中，对押投注意味着玩家可以同时投注庄家和闲家。

名称范例

请求

                                    
{
    "GpId": "1",
    "IsGetAll": "true",
    "CompanyKey": "<%= CompanyKey %>",
    "ServerId": "YY-TEST"
}

回应


{
    "seamlessGameProviderGames": [
        {
          "gameProviderId": 0,
          "gameID": 0,
          "gameType": 9,
          "rank": 1,
          "device": "",
          "platform": "",
          "provider": "WanMei",
          "rtp": 0,
          "rows": 0,
          "reels": 0,
          "lines": 0,
          "gameInfos": [
            {
              "language": "en",
              "gameName": "WmLobby",
              "gameIconUrl": "/images/casinos/CasinoImgWM-en.png"
            },
            {
              "language": "zh_cn",
              "gameName": "完美赌场大厅",
              "gameIconUrl": "/images/casinos/CasinoImgWM-en.png"
            }
          ],
          "supportedCurrencies": ["AUD","BND","CNY","EUR","GBP","HKD","IDR","INR","JPY","KRW","MMK","MYR","NZD","PHP","SEK","THB","USD","VND","ZAR"],
          "blockCountries": [],
          "isMaintain": false,
          "isEnabled": true,
          "isProvideCommission": false,
          "hasHedgeBet": false
        }
    ],
    "error": {
        "id": 0,
        "msg": "NoError"
    },
    "serverId": "YY-TEST"
}

8.2 获取赛事推荐

该API将返回最推荐的三场比赛
只会推荐足球的五大联赛、欧冠杯、世界杯及E-football
五大联赛包括 : 英格兰超级联赛,意大利甲组联赛,德国甲组联赛,西班牙甲组联赛,法国甲组联赛

URL	/web-root/restricted/information/get-recommend-matches.aspx

请求

参数	资料形态	描述 * 为必须参数
companyKey*	String(32)	平台和白牌系统之间的预先定义的一组私钥。
serverId*	String(15)	自行设定之伺服器名称，每个伺服器名称需唯一。此ID用于故障排除。
language*	String(10)	請參考 9.4 语言

回应

参数

资料形态

描述

leagueName

String(100)

联赛名称

matchId

Integer

推荐赛事的 MatchId, 可以用在 3.3 导页至体育博彩

homeName

String(200)

主队名称

awayName

String(200)

客队名称

kickOffTime

DateTime

开踢时间

gameTime

String(10)

可能的值为:
HT, 1H15, 2H30 等等.
HT 代表半场, 1H 代表上半场, 15 代表开踢 15 分钟
非滾球賽事则为空值

homeScore

Integer

主队目前分数

awayScore

Integer

客队目前分数

homeTeamIconUrl

String(200)

主队图标 url

awayTeamIconUrl

String(200)

客队图标 url

handicap

RecommendOdds

让分盘赔率

homeOdds	Decimal	主队赔率
awayOdds	Decimal	客队赔率
point	Decimal	让分数 Point 为正代表主队让分 Point 为负代表客队让分

overUnder

RecommendOdds

大小盘赔率

homeOdds	Decimal	大盘赔率
awayOdds	Decimal	小盘赔率
point	Decimal	大小盤分數

名称范例

请求

{
    "language": "en",
    "companyKey": "<%= CompanyKey %>",
    "serverId": "YY-TEST"
}

回应

{
    "recommendMatches": [
        {
            "leagueName": "ENGLISH PREMIER LEAGUE",
            "matchId": 24800005,
            "homeName": "Wolverhampton Wanderers",
            "awayName": "Manchester City",
            "kickOffTime": "2022-09-17T07:35:00",
            "gameTime": "HT",
            "homeScore": 0,
            "awayScore": 0,
            "homeTeamIconUrl": "https://img-2-2.cdn568.net/images/teamLogo/WolverhamptonWanderers.png",
            "awayTeamIconUrl": "https://img-2-2.cdn568.net/images/teamLogo/ManchesterCity.png",
            "handicap": {
                "homeOdds": -0.83,
                "awayOdds": 0.76,
                "point": -1.25
            },
            "overUnder": {
                "homeOdds": 0.72,
                "awayOdds": -0.82,
                "point": 2.75
            }
        },
        {
            "leagueName": "ENGLISH PREMIER LEAGUE",
            "matchId": 24800003,
            "homeName": "Nottingham Forest",
            "awayName": "Fulham",
            "kickOffTime": "2022-09-16T15:05:00",
            "gameTime": "HT",
            "homeScore": 0,
            "awayScore": 0,
            "homeTeamIconUrl": "https://img-2-2.cdn568.net/images/teamLogo/NottinghamForest.png",
            "awayTeamIconUrl": "https://img-2-2.cdn568.net/images/teamLogo/Fulham.png",
            "handicap": {
                "homeOdds": -0.92,
                "awayOdds": 0.85,
                "point": 0
            },
            "overUnder": {
                "homeOdds": 0.74,
                "awayOdds": -0.84,
                "point": 2.25
            }
        },
        {
            "leagueName": "SPAIN LA LIGA",
            "matchId": 24568400,
            "homeName": "Barcelona",
            "awayName": "Elche CF",
            "kickOffTime": "2022-09-17T10:20:00",
            "gameTime": "HT",
            "homeScore": 0,
            "awayScore": 0,
            "homeTeamIconUrl": "https://img-2-2.cdn568.net/images/teamLogo/Barcelona.png",
            "awayTeamIconUrl": "https://img-2-2.cdn568.net/images/teamLogo/ElcheCF.png",
            "handicap": {
                "homeOdds": 0.84,
                "awayOdds": -0.91,
                "point": 2.5
            },
            "overUnder": {
                "homeOdds": 0.78,
                "awayOdds": -0.88,
                "point": 3.5
            }
        }
    ],
    "error": {
        "id": 0,
        "msg": "NoError"
    },
    "serverId": "YY-TEST"
}

9.附件

9.1 API 错误

Value	描述
0	No Error
1	无效的Company Key
2	无效的Json格式
3	内部错误
4	无效的会员名称
5	无效的国家
6	无效的语言
8	无效的请求格式
13	请选择安全系数更高的账号。建议您使用字母、数字和 '_' 的组合
3101	无效的币别
3102	无效的主题Id
3104	创建代理失败
3201	更新状态失败
3202	无效的会员名称-更新状态
3203	已更新状态
3204	无效的状态
3205	无效的日期
3206	无效的单笔注单最低限额
3207	无效的单笔注单最高限额
3208	无效的单场比赛最高限额
3209	无效的真人赌场下注设定
3303	用户不存在
4101	代理不存在
4102	创建会员失败
4103	会员名称存在
4106	代理帐号为关闭状态
4107	請創建在代理而非下线底下
4201	验证失败
4401	无效的交易Id
4402	无效的交易金额. 比如:输入金额为负值或输入金额含有超过两位小数 (范例: 19.217 和 19.2245 均会报错)
4403	交易失败
4404	重复使用相同的交易Id
4501	余额不足
4502	于余额不足导致的回滚(Rollback Transaction)交易
4601	检查交易状态失败
4602	未找到任何交易
4701	获得余额失败
6101	获取客户报表失败
6102	获取客户注单失败
6666	没有此下注纪录
9527	无效的运动类型
9528	无效的盘口
9720	提款请求次数太过频繁
9721	无效的密码格式

9.2 币别


                    白牌系统支持多种货币设定。但是一个代理/玩家的帐户只能在创建帐户时设定一种货币，且在创建帐户后便不可再进行更改。
                    
关于货币与地区IP的对应. 我们使用 Maxmind GeoIP 来辨识您的IP地区。

                    针对 VND 与 IDR 在我们系统上的比例为1:1000。例: 白牌系统上显示的 1 IDR 等同于 1000 真实的印尼盾。
                    针对 VNO 与 IDO 在我们系统上的比例为1:1。例: 白牌系统上显示的 1 IDO 等同于 1 真实的印尼盾。
                    针对 MYK 在我们系统上的比例为1:1000。例: 白牌系统上显示的 1 MYK 等同于 1000 真实的缅甸元。

币别	地区	描述
AED	AE	地区IP若為AE，货币僅能使用迪拉姆。
AFN	AF	地区IP若為AF，货币僅能使用阿富汗尼。
ALL	AL	地区IP若為AL，货币僅能使用阿尔巴尼亚列克。
AMD	AM	地区IP若為AM，货币僅能使用亚美尼亚德拉姆。
ANG	CW	地区IP若為CW，货币僅能使用荷属安的列斯盾。
ANG	SX	地区IP若為SX，货币僅能使用荷属安的列斯盾。
AOA	AO	地区IP若為AO，货币僅能使用安哥拉宽扎。
ARS	AR	地区IP若為AR，货币僅能使用阿根廷比索。
AUD	AU	地区IP若為AU，货币僅能使用澳元。
AWG	AW	地区IP若為AW，货币僅能使用阿鲁巴弗罗林。
AZN	AZ	地区IP若為AZ，货币僅能使用阿塞拜疆马纳特。
BAM	BA	地区IP若為BA，货币僅能使用波斯尼亚和黑塞哥维那可兑换马克。
BBD	BB	地区IP若為BB，货币僅能使用巴巴多斯元。
BDT	BD	地区IP若為BD，货币僅能使用孟加拉塔卡。
BGN	BG	地区IP若為BG，货币僅能使用保加利亚列弗。
BHD	BH	地区IP若為BH，货币僅能使用巴林第纳尔。
BIF	BI	地区IP若為BI，货币僅能使用布隆迪法郎。
BMD	BM	地区IP若為BM，货币僅能使用百慕大元。
BND	BN	地区IP若為BN，货币僅能使用文莱元。
BOB	BO	地区IP若為BO，货币僅能使用玻利维亚诺。
BRL	BR	地区IP若為BR，货币僅能使用雷亚尔。
BSD	BS	地区IP若為BS，货币僅能使用巴哈马元。
BTN	BT	地区IP若為BT，货币僅能使用不丹努尔特鲁姆。
BWP	BW	地区IP若為BW，货币僅能使用博茨瓦纳普拉。
BYN	BY	地区IP若為BY，货币僅能使用白俄罗斯卢布。
BZD	BZ	地区IP若為BZ，货币僅能使用伯利兹元。
CAD	CA	地区IP若為CA，货币僅能使用加元。
CDF	CD	地区IP若為CD，货币僅能使用刚果法郎。
CHF	CH	地区IP若為CH，货币僅能使用联邦瑞士法郎（瑞郎）。
CLP	CL	地区IP若為CL，货币僅能使用智利比索。
CNY	CN	地区IP若為CN，货币僅能使用人民币。
COP	CO	地区IP若為CO，货币僅能使用哥伦比亚披索。
CRC	CR	地区IP若為CR，货币僅能使用哥斯达黎加科朗。
CUP	CU	地区IP若為CU，货币僅能使用古巴比索。
CVE	CV	地区IP若為CV，货币僅能使用佛得角埃斯库多。
CZK	CZ	地区IP若為CZ，货币僅能使用捷克克朗。
DJF	DJ	地区IP若為DJ，货币僅能使用吉布提法郎。
DKK	DK, FO, GL	地区IP若為DK、FO、GL，货币僅能使用丹麦克朗。
DOP	DO	地区IP若為DO，货币僅能使用多米尼加比索。
DZD	DZ	地区IP若為DZ，货币僅能使用阿尔及利亚第纳尔。
EGP	EG	地区IP若為EG，货币僅能使用埃及镑。
ERN	ER	地区IP若為ER，货币僅能使用厄立特里亚纳克法。
ETB	ET	地区IP若為ET，货币僅能使用埃塞俄比亚比尔。
EUR	欧元区	地区IP若為欧元区，货币僅能使用欧元。
FJD	FJ	地区IP若為FJ，货币僅能使用斐济元。
FKP	FK	地区IP若為FK，货币僅能使用福克兰群岛镑。
GBP	GB	地区IP若為GB，货币僅能使用英镑。
GEL	GE	地区IP若為GE，货币僅能使用格鲁吉亚拉里。
GHS	GH	地区IP若為GH，货币僅能使用加纳塞地。
GIP	GI	地区IP若為GI，货币僅能使用直布罗陀镑。
GMD	GM	地区IP若為GM，货币僅能使用冈比亚达拉西。
GNF	GN	地区IP若為GN，货币僅能使用几内亚法郎。
GTQ	GT	地区IP若為GT，货币僅能使用危地马拉格查尔。
GYD	GY	地区IP若為GY，货币僅能使用圭亚那元。
HKD	HK	地区IP若為HK，货币僅能使用港币。
HNL	HN	地区IP若為HN，货币僅能使用洪都拉斯伦皮拉。
HTG	HT	地区IP若為HT，货币僅能使用海地古德。
HUF	HU	地区IP若為HU，货币僅能使用匈牙利福林。
IDO	ID	地区IP若為ID，货币僅能使用印尼币。
IDR	ID	地区IP若為ID，货币僅能使用印尼盾。
ILS	IL, PS	地区IP若為IL、PS，货币僅能使用以色列新谢克尔。
INR	IN	地区IP若為IN，货币僅能使用印度盧比。
IQD	IQ	地区IP若為IQ，货币僅能使用伊拉克第纳尔。
IRR	IR	地区IP若為IR，货币僅能使用伊朗里亚尔。
ISK	IS	地区IP若為IS，货币僅能使用冰岛克朗。
JMD	JM	地区IP若為JM，货币僅能使用牙买加元。
JOD	JO	地区IP若為JO，货币僅能使用约旦第纳尔。
JPY	JP	地区IP若為JP，货币僅能使用日圆。
KES	KE	地区IP若為KE，货币僅能使用肯尼亚先令。
KGS	KG	地区IP若為KG，货币僅能使用吉尔吉斯斯坦索姆。
KHR	KH	地区IP若為KH，货币僅能使用柬埔寨里尔。
KMF	KM	地区IP若為KM，货币僅能使用科摩罗法郎。
KPW	KP	地区IP若為KP，货币僅能使用朝鲜圆。
KRW	KR	地区IP若為KR，货币僅能使用韩元。
KWD	KW	地区IP若為KW，货币僅能使用科威特第纳尔。
KYD	KY	地区IP若為KY，货币僅能使用开曼群岛元。
KZT	KZ	地区IP若為KZ，货币僅能使用哈萨克斯坦坚戈。
LAK	LA	地区IP若為LA，货币僅能使用寮国基普。
LBP	LB	地区IP若為LB，货币僅能使用黎巴嫩镑。
LKR	LK	地区IP若為LK，货币僅能使用斯里兰卡卢比。
LRD	LR	地区IP若為LR，货币僅能使用利比里亚元。
LSL	LS	地区IP若為LS，货币僅能使用莱索托洛蒂。
LYD	LY	地区IP若為LY，货币僅能使用利比亚第纳尔。
MAD	MA	地区IP若為MA，货币僅能使用摩洛哥迪尔汗。
MDL	MD	地区IP若為MD，货币僅能使用摩尔多瓦列伊。
MGA	MG	地区IP若為MG，货币僅能使用马达加斯加阿里亚里。
MKD	MK	地区IP若為MK，货币僅能使用马其顿代纳尔。
MMK	MM	地区IP若為MM，货币僅能使用缅甸元。
MNT	MN	地区IP若為MN，货币僅能使用蒙古图格里克。
MOP	MO	地区IP若為MO，货币僅能使用澳門元。
MRU	MR	地区IP若為MR，货币僅能使用毛里塔尼亚乌吉亚。
MUR	MU	地区IP若為MU，货币僅能使用毛里求斯卢比。
MVR	MV	地区IP若為MV，货币僅能使用马尔代夫拉菲亚。
MWK	MW	地区IP若為MW，货币僅能使用马拉维克瓦查。
MXN	MX	地区IP若為MX，货币僅能使用墨西哥元。
MYK	MM	地区IP若為MM，货币僅能使用缅甸元。
MYR	MY	地区IP若為MY，货币僅能使用马来西亚令吉。
MZN	MZ	地区IP若為MZ，货币僅能使用莫桑比克梅蒂卡尔。
NAD	NA	地区IP若為NA，货币僅能使用纳米比亚元。
NGN	NG	地区IP若為NG，货币僅能使用尼日利亚奈拉。
NIO	NI	地区IP若為NI，货币僅能使用尼加拉瓜科多巴。
NOK	NO	地区IP若為NO，货币僅能使用挪威币。
NPR	NP	地区IP若為NP，货币僅能使用尼泊尔。
NZD	NZ	地区IP若為NZ，货币僅能使用新西兰币
OMR	OM	地区IP若為OM，货币僅能使用阿曼里亚尔。
PAB	PA	地区IP若為PA，货币僅能使用巴拿马巴波亚。
PEN	PE	地区IP若為PE，货币僅能使用秘鲁索尔。
PGK	PG	地区IP若為PG，货币僅能使用巴布亚新几内亚基那。
PKR	PK	地区IP若為PK，货币僅能使用巴基斯坦卢比。
PLN	PL	地区IP若為PL，货币僅能使用波兰兹罗提。
PYG	PY	地区IP若為PY，货币僅能使用巴拉圭瓜拉尼。
QAR	QA	地区IP若為QA，货币僅能使用卡塔尔里亚尔。
RON	RO	地区IP若為RO，货币僅能使用罗马尼亚列伊。
RSD	RS	地区IP若為RS，货币僅能使用塞尔维亚第纳尔。
RUB	RU	地区IP若為RU，货币僅能使用卢布
RWF	RW	地区IP若為RW，货币僅能使用卢旺达法郎。
SAR	SA	地区IP若為SA，货币僅能使用沙特里亚尔。
SBD	SB	地区IP若為SB，货币僅能使用所罗门群岛元。
SCR	SC	地区IP若為SC，货币僅能使用塞舌尔卢比。
SDG	SD	地区IP若為SD，货币僅能使用苏丹镑。
SEK	SE	地区IP若為SE，货币僅能使用瑞典克朗。
SLL	SL	地区IP若為SL，货币僅能使用塞拉利昂利昂。
SOS	SO	地区IP若為SO，货币僅能使用索马里先令。
SRD	SR	地区IP若為SR，货币僅能使用苏里南元。
SSP	SS	地区IP若為SS，货币僅能使用南苏丹镑。
STN	ST	地区IP若為ST，货币僅能使用圣多美和普林西比多布拉。
SYP	SY	地区IP若為SY，货币僅能使用叙利亚镑。
SZL	SZ	地区IP若為SZ，货币僅能使用斯威士兰里兰吉尼。
THB	TH	地区IP若為TH，货币僅能使用泰铢。
TJS	TJ	地区IP若為TJ，货币僅能使用塔吉克斯坦索莫尼。
TMT	TM	地区IP若為TM，货币僅能使用土库曼斯坦马纳特。
TND	TN	地区IP若為TN，货币僅能使用突尼斯第纳尔。
TOP	TO	地区IP若為TO，货币僅能使用汤加潘加。
TRY	TR	地区IP若為TR，货币僅能使用土耳其里拉。
TTD	TT	地区IP若為TT，货币僅能使用特立尼达和多巴哥元。
TZS	TZ	地区IP若為TZ，货币僅能使用坦桑尼亚先令。
UAH	UA	地区IP若為UA，货币僅能使用乌克兰格里夫纳。
UCC	非欧元地区	UCC为我方USDT，地区IP若為非欧元地区，货币能使用USDT。
UGX	UG	地区IP若為UG，货币僅能使用乌干达先令。
USD	非欧元地区	地区IP若為非欧元地区，货币僅能使用美元。
UYU	UY	地区IP若為UY，货币僅能使用乌拉圭比索。
UZS	UZ	地区IP若為UZ，货币僅能使用乌兹别克斯坦索姆。
VES	VE	地区IP若為VE，货币僅能使用委内瑞拉。
VND	VN	地区IP若為VN，货币僅能使用越南盾。
VNO	VN	地区IP若為VN，货币僅能使用越南币。
VUV	VU	地区IP若為VU，货币僅能使用瓦努阿图瓦图。
WST	WS	地区IP若為WS，货币僅能使用萨摩亚塔拉。
XAF	CF, CG, CM, GA, GQ, TD	地区IP若為CF、CG、CM、GA、GQ、TD，货币僅能使用中非金融合作法郎。
XCD	AG, AI, DM, GD, KN, LC, MS, VC	地区IP若為AG、AI、DM、GD、KN、LC、MS、VC，货币僅能使用东加勒比元。
XOF	BJ, BF, CI, GW, ML, NE, SN, TG	地区IP若為BJ、BF、CI、GW、ML、NE、SN、TG，货币僅能使用西非法郎/ 非洲金融共同体法郎。
XPF	NC, PF, WF	地区IP若為NC、PF、WF，货币僅能使用太平洋法郎。
YER	YE	地区IP若為YE，货币僅能使用也门里亚尔。
ZAR	ZA	地区IP若為ZA，货币僅能使用南非兰特。
ZMW	ZM	地区IP若為ZM，货币僅能使用赞比亚克瓦查。

9.3 主题

體育登入前頁面

HTTP 版本 URL:
http://sports-bsi.sswwkk.com/web-root/restricted/default.aspx?lang=en&theme=black
HTTPS 版本 URL:
https://sports-bsi.sswwkk.com/web-root/restricted/default.aspx?lang=en&theme=black

ID	名称	Desktop	Mobile
1	Black	V
2	Blue	V
3	Green	V
4	Ocean	V
5	SBO	V	V (将要淘汰)
6	Lawn	V
7	SBOLite		V
8	SBOBET-m		V
9	SBOMain	V (默认)	V (默认)
10	SBOChina		V

Black theme (仅支援桌面版本)

Blue theme (仅支援桌面版本)

Green theme (仅支援桌面版本)

Ocean theme (仅支援桌面版本)

SBO theme (支援桌面及手机版本)

Lawn theme (支援桌面及手机版本)

SBOLite theme (支援手机版本)

Sbobet-m theme (支援手机版本)

SBO Main theme (支援桌面及手机版本)

SBO China theme (支援手机版本)(仅支援简体中文)

9.4 语言

V : Supports     △ : will be presented in English

Value	描述	Supported In Sports	Supported In Live Casino	Supported In Games	Supported In VirtualSports
en	English	V	V	V	V
zh-tw	Traditional Chinese	V			V
zh-cn	Simplify Chinese	V	V		V
th-th	Thai	V	V		V
id-id	Indonesia	V			V
ja-jp	Japanese	V	V		△
ko-kr	Korea	V	V		△
vi-vn	Vietnamese	V			△
de-de	Deutsch	V			△
es-es	Español	V			△
fr-fr	Français	V
ru-ru	Pусский(Russia Language)	V			△
pt-pt	Português	V
my-mm	Burmese	V
km-kh	ភាសាខ្មែរ	V

9.5 运动类型

Sport Type Id	Enum value	Actual value that our API will return
0	全部	ALL
1	足球	Football
2	篮球	Basketball
3	美式足球	American Football
4	冰棍球	Ice Hockey
5	羽毛球	Badminton
6	撞球/斯诺克	Pool/Snooker
7	赛车	Motor Sport
8	网球	Tennis
9	棒球	Baseball
10	排球	Volleyball
11	其他	Others
12	高尔夫	Golf
13	拳击	Boxing
14	板球	Cricket
15	乒乓球	Table Tennis
16	橄榄球	Rugby
17	手球	Handball
18	自行车	Cycling
19	竞技	Athletics
20	沙滩足球	Beach Soccer
21	室内足球	Futsal
22	特别	Special
23	金融	Financial
24	飞镖	Darts
25	奥运会	Olympic
26	长曲棍球	Lacrosse
27	水球	Water Polo
28	冬季运动	Winter Sports
29	壁球	Squash
30	草地曲棍球	Field Hockey
31	综合格斗	Mixed Martial Arts
32	电子竞技	E Sports
33	盖尔足球	Gaelic Football
34	板棍球	Hurling
35	泰拳	Muay Thai
36	澳式足球	Aussie Rules Football
37	班迪	Bandy
38	冬奥会	Winter Olympics

9.6 盘口

Market Type Id	Enum value	Actual value that our API will return	翻译	备注
0	ALL	ALL	全部
1	Handicap	Handicap	亚洲盘
2	Odd_Even	Odd/Even	单/双盘
3	Over_Under	Over/Under	大小盘
4	Correct_Score	Correct Score	波胆
5	_1X2	1X2	主客和
6	Total_Goal	Total Goal	总进球
7	First_Half_Hdp	First Half Hdp	半场让分盘
8	First_Half_1x2	First Half 1x2	半场1x2
9	First_Half_O_U	First Half O/U	半场大小盘
10	HT_FT	HT/FT	半场/ 全场
11	Money_Line	Money Line	独赢
12	First_Half_O_E	First Half O/E	半场单双
13	First_Goal_Last_Goal	First Goal/Last Goal	最先得分/ 最后得分
14	First_Half_C_S	First Half CS	半场波胆
15	Double_Chance	Double Chance	双重机会
16	Live_Score	Live Score	当前比分	亚洲 1X2
17	First_Half_Live_Score	First Half Live Score	半场当前比分	半场亚洲 1X2
39	OutRight	Outright	优胜冠军
40	Multiple_Bet	Mix Parlay	串关
666	In Between	In Between	射龍門	无法在修改代理/玩家下注设定等接口中使用
800000	FirstHalfOverUnder1X2	First Half 1X2 & O/U	半场 1X2 & 大小盘	无法在修改代理/玩家下注设定等接口中使用
800001	FirstHalfOverUnderDoubleChance	D/C & First Half O/U	双重机会 & 半场大小盘	无法在修改代理/玩家下注设定等接口中使用
900000	OverUnder1X2	1X2 & O/U	1X2 & 大小盘	无法在修改代理/玩家下注设定等接口中使用
900001	OverUnderDoubleChance	D/C & O/U	双重机会 & 大小盘	无法在修改代理/玩家下注设定等接口中使用
800002	FirstHalfReverseCorrectScore	First Half RCS	上半场反波胆	无法在修改代理/玩家下注设定等接口中使用
900002	ReverseCorrectScore	Reverse Correct Score	反波胆	无法在修改代理/玩家下注设定等接口中使用

9.7 虚拟体育盘口

Market Type	Market Type
OverUnder	AsianHandicap
OneXTwo	MixParlay
FirstHalfOneXTwo	FirstHalfOverUnder
FirstHalfAsianHandicap	CorrectScore
TotalGoal	MoneyLine
CupWinner	NotSupport
FH Over/Under	Correct Score
Handicap	Over/Under
Money Line	Total Goal
FH Handicap	FH 1X2
1X2

9.8 无缝游戏提供商

强烈推薦使用第三方游戏的GAMES LOBBY 或者 CASINO LOBBY, 因为大厅既简单也方便玩家使用大厅包含所有游戲以及线上真人第三方游戲以及线上真人的列表請參照: 第三方游戲资讯

9.8.1 第三方体育提供商

第三方体育的列表請參照: 第三方体育资讯

9.9 注单列表

白牌系统内的注单列表根据不同类别分成五种

体育注单列表

参数	资料形态	描述
refNo	String(100)	投注编号
username	String(40)	下注的玩家名称
sportsType	String	下注的体育类型
orderTime	DateTime	玩家下注的时间
winLostDate	DateTime	注单的归帐日。(格式为日期请忽略时间部分"00:00:00")(仅在注单结算后显示)
settleTime	DateTime	注单被结算的时间。若注单有被重新结算(won, lose, draw或void)，settleTime也会同步更新。
modifyDate	DateTime	修改日期
odds	decimal	下注的赔率
oddsStyle	String(20)	下注的赔率类别 `M : Malay odds H : HongKong odds E : Euro odds I : Indonesia odds`
stake	decimal	玩家的投注金
actualStake	decimal	玩家的实际投注金。在特别的下注赔率会与注金(stake)不同
currency	String(3)	请参考币别.
status	String(10)	玩家的注单状态
winlost	decimal	玩家的注单净赢
turnover	decimal	玩家的流水
turnoverByStake	decimal	依据投注额的总投注流水
turnoverByActualStake	decimal	依据有效投注额的总投注流水
netTurnoverByStake	decimal	依据投注额的淨投注流水
netTurnoverByActualStake	decimal	依据有效投注额的淨投注流水
isHalfWonLose	Bool	是否为半场获胜或半场失败
isLive	Bool	是否为现场赛事
maxWinWithoutActualStake	decimal	注单未清算，将回传当前不包含注金(ActualStake)的最大净赢。当注单清算时，将回传当前不包含注金(ActualStake)的预估净赢。
ip	String	玩家下注的ip
subBet	Object	注单的子注单
sportsType	String	運動類型
IsSystemTagRisky	Bool	注單是否被風控檢測到
VoidReason	String	注單退款/取消之原因
isCustomerTagRisky	Bool	玩家是否被風控檢測到
topDownline	String	直屬下綫的用戶名/自己的用戶名如果注單是下綫的，會顯示屬於你直屬下綫的用戶名如果注單是自己的，會顯示自己的用戶名
isCashOut	Bool	注單是否被撤单套现

范例


"result": [
    {
      "subBet": [
        {
          "betOption": "e-Bordeaux",
          "marketType": "Handicap",
          "sportType": "Football",
          "hdp": 0.5,
          "odds": 1.74,
          "league": "e-Football F22 Elite Club Friendly",
          "match": "e-Borussia Dortmund vs e-Bordeaux",
          "status": "lose",
          "winlostDate": "2023-01-07T00:00:00",
          "liveScore": "2:3",
          "htScore": "2:1",
          "ftScore": "3:3",
          "customeizedBetType": "",
          "kickOffTime": "2023-01-07T00:00:00",
          "isHalfWonLose": false
        }
      ],
      "sportsType": "Football",
      "odds": 1.74,
      "oddsStyle": "E",
      "isLive": true,
      "maxWinWithoutActualStake": 0.74,
      "ip": "61.220.125.7",
      "isSystemTagRisky": false,
      "isCustomerTagRisky": false,
      "voidReason": "",
      "actualStake": 1,
      "turnover": 1,
      "isHalfWonLose": false,
      "isCashOut": false,
      "turnoverByStake": 1,
      "turnoverByActualStake": 1,
      "netTurnoverByStake": 1,
      "netTurnoverByActualStake": 1,
      "orderTime": "2023-01-07T00:26:34.633",
      "modifyDate": "2023-01-07T00:34:29.987",
      "settleTime": "2023-01-07T00:34:23.467",
      "winLostDate": "2023-01-07T00:00:00",
      "refNo": "77647260",
      "username": "testPlayer",
      "currency": "USD",
      "stake": 1,
      "winLost": -1,
      "status": "lose",
      "topDownline": null
    }
  ]

体育博彩注单明细

参数	描述
betOption	String(100)	会员在此投注中选择的选项。
marketType	String(20)	盘口的类型。
sportType	String	運動類型
hdp	decimal	下注选项的让球数。
odds	decimal	下注选项的赔率。
league	String(20)	本场赛事的联赛名称。
match	String(20)	赛事的名称。
status	String(50)	注单的状态
winlostDate	DateTime	注单的归帐日。(格式为日期请忽略时间部分"00:00:00")(仅在注单结算后显示)
liveScore	String(20)	如果为滚球赛事，将记录玩家下注时的比分。
htScore	String(20)	赛事的半场比分。
ftScore	String(20)	赛事的全场比分。
customeizedBetType	String(20)	会员下注的Group名称，例如:Total Corner,...
kickOffTime	DateTime	开赛时间
isHalfWonLose	Bool	是否为半场获胜或半场失败

范例


{
    "betOption": "e-Bordeaux",
    "marketType": "Handicap",
    "sportType": "Football",
    "hdp": 0.5,
    "odds": 1.74,
    "league": "e-Football F22 Elite Club Friendly",
    "match": "e-Borussia Dortmund vs e-Bordeaux",
    "status": "lose",
    "winlostDate": "2023-01-07T00:00:00",
    "liveScore": "2:3",
    "htScore": "2:1",
    "ftScore": "3:3",
    "customeizedBetType": "",
    "kickOffTime": "2023-01-07T00:00:00",
    "isHalfWonLose": false
}

真人赌场注单列表

参数	资料形态	描述
orderTime	DateTime	玩家下注的时间
modifyDate	DateTime	注单的修改时间
refNo	String(100)	代码开头为'T'，表示为game的注单。代码开头为'B'，表示为Casino, Baccarat or Super6的注单。可以通过查看下面的tableName找到Baccarat和Super6之间的区别。代码开头为'R'，表示为Casino, Roulette的注单。代码开头为'S'，表示为Casino, SicBo的注单。代码开头为'O'，表示为Casino, DragonTiger的注单。
username	String(40)	下注的玩家名称
gameId	String	本轮赛事的ID
tableName	String	当前投注的游戏名称
currency	String(5)	请参考币别.
stake	decimal	玩家的投注金
turnover	decimal	玩家的流水
winlost	decimal	玩家的注单净赢
productType	String	真人赌场游戏产品类别
status	String	玩家的注单状态
winlostDate	DateTime	注单的归帐日。(格式为日期请忽略时间部分"00:00:00")(仅在注单结算后显示)
settleTime	DateTime	注单被结算的时间。若注单有被重新结算(won, lose, draw或void)，settleTime也会同步更新。
topDownline	String	直屬下綫的用戶名/自己的用戶名如果注單是下綫的，會顯示屬於你直屬下綫的用戶名如果注單是自己的，會顯示自己的用戶名

范例


"result": [
    {
      "gameId": 64157901,
      "tableName": "Baccarat C7-75C",
      "turnover": 20,
      "productType": "Baccarat",
      "orderTime": "2023-01-09T02:55:05.587",
      "modifyDate": "2023-01-09T02:55:38.063",
      "settleTime": "2023-01-09T02:55:20.893",
      "winLostDate": "2023-01-09T00:00:00",
      "refNo": "B0011233026545",
      "username": "testPlayer",
      "currency": "USD",
      "stake": 20,
      "winLost": 19,
      "status": "won",
      "topDownline": null
    }
]

电子游戏注单列表

参数	资料形态	描述
orderTime	DateTime	玩家下注的时间
modifyDate	DateTime	注单的修改时间
refNo	String(100)	代碼開頭為'T'，表示为game的注单。代碼開頭為'B'，表示为VirtualSports的注单。
username	String(40)	下注的玩家名称
gameId	String	本轮赛事的ID
gameName	String	当前投注的游戏名称
currency	String(5)	请参考币别.
stake	decimal	玩家的投注金
turnover	decimal	玩家的流水
winlost	decimal	玩家的注单净赢
productType	String	电子游戏产品类别
status	String	玩家的注单状态
settleTime	DateTime	注单被结算的时间。若注单有被重新结算(won, lose, draw或void)，settleTime也会同步更新。
winlostDate	DateTime	注单的归帐日。(格式为日期请忽略时间部分"00:00:00")(仅在注单结算后显示)
topDownline	String	直屬下綫的用戶名/自己的用戶名如果注單是下綫的，會顯示屬於你直屬下綫的用戶名如果注單是自己的，會顯示自己的用戶名

范例


"result": [
    {
      "gameId": 10834,
      "gameName": "Royal Roulette",
      "turnover": 5,
      "productType": "TableGamesRouletteHtml5",
      "orderTime": "2023-01-09T03:10:34.087",
      "modifyDate": "2023-01-09T03:10:43.087",
      "settleTime": "2023-01-09T03:10:34.087",
      "winLostDate": "2023-01-09T00:00:00",
      "refNo": "T10834",
      "username": "testPlayer",
      "currency": "USD",
      "stake": 5,
      "winLost": 5,
      "status": "won",
      "topDownline": null
    }
]

虚拟体育注单列表

参数资料形态描述

orderTime DateTime 玩家下注的时间

modifyDate DateTime 注单的修改时间

refNo String(100) 用于表示下注的唯一字符串

username String(40) 下注的玩家名称

gameId Integer 本轮赛事的ID

odds decimal 下注的赔率

oddsStyle

String(20)

下注的赔率类别


    Malay : Malay odds
    HK : HongKong odds
    Euro : Euro odds
    Indo : Indonesia odds

currency String(5) 请参考币别.

stake decimal 玩家的投注金

actualStake decimal 玩家的实际投注金。在特别的下注赔率会与注金(stake)不同

turnover decimal 玩家的流水

winLost decimal 玩家的注单净赢

status String(10) 玩家的注单状态

productType

String

虚拟体育游戏产品类别

VirtualFootballMobile-虛擬足球手機版	VirtualFootballDesktop-虛擬足球桌面版
VirtualBasketballDesktop-虛擬籃球桌面版	VirtualBasketballMobile-虛擬籃球手機版
VirtualEuroCupDesktop-虛擬歐洲杯桌面版	VirtualEuroCupMobile-歐洲杯手機版
VirtualAsianCupDesktop-虛擬亞洲杯桌面版	VirtualAsianCupMobile-虛擬亞洲杯手機版
VirtualChampionsCupDesktop-虛擬冠軍杯桌面版	VirtualChampionsCupMobile-虛擬冠軍杯手機版
Bundesliga

winLostDate DateTime 注单的归帐日。(格式为日期请忽略时间部分"00:00:00")(仅在注单结算后显示)

settleTime DateTime 注单被结算的时间。若注单有被重新结算(won, lose, draw或void)，settleTime也会同步更新。

topDownline String 直屬下綫的用戶名/自己的用戶名
如果注單是下綫的，會顯示屬於你直屬下綫的用戶名
如果注單是自己的，會顯示自己的用戶名

subBet Object 子注单

范例


"result": [
    {
        "gameId": 2672418,
        "odds": 1.2,
        "oddsStyle": "Euro",
        "actualStake": 5,
        "turnover": 5,
        "productType": "VirtualFootballDesktop",
        "subBet": [
        {
            "htScore": "0:0",
            "ftScore": "1:0",
            "betOption": "Over",
            "marketType": "FH Over/Under",
            "hdp": "0.5",
            "odds": 1.2,
            "match": "VL Amsterdam -vs- VL Kiev",
            "status": "Lose",
            "winLostDate": "2023-01-09T00:00:00"
        }
        ],
        "orderTime": "2023-01-09T03:14:40.07",
        "modifyDate": "2023-01-09T04:43:18.2",
        "settleTime": "2023-01-09T04:43:10.877",
        "winLostDate": "2023-01-09T00:00:00",
        "refNo": "B2672418",
        "username": "testPlayer",
        "currency": "USD",
        "stake": 5,
        "winLost": -5,
        "status": "lose",
        "topDownline": null
    }
]

虚拟运动博彩子注单明细

参数	资料形态	描述
betOption	String(100)	会员在此投注中选择的选项
marketType	String(20)	虚拟运动盘口
hdp	String(20)	下注选项的让球数
odds	decimal	下注选项的赔率
league	String(20)	本场赛事的联赛名称
match	String(20)	赛事的名称
status	String(20)	玩家的注单状态
winlostDate	DateTime	注单的归帐日。(格式为日期请忽略时间部分"00:00:00")(仅在注单结算后显示)
settleTime	DateTime	注单被结算的时间。若注单有被重新结算(won, lose, draw或void)，settleTime也会同步更新。
liveScore	String(20)	若为滚球赛事，将记录玩家下注时的比分
htScore	String(20)	赛事的半场比分
ftScore	String(20)	赛事的全场比分
customeizedBetType	String(20)	会员下注的种类名称

范例


{
    "htScore": "0:0",
    "ftScore": "1:0",
    "betOption": "Over",
    "marketType": "FH Over/Under",
    "hdp": "0.5",
    "odds": 1.2,
    "match": "VL Amsterdam -vs- VL Kiev",
    "status": "Lose",
    "winLostDate": "2023-01-09T00:00:00"
}

无缝游戏注单列表

参数	资料形态	描述
orderTime	DateTime	玩家下注的时间
modifyDate	DateTime	注单的修改时间
refNo	String(100)	用于表示下注的唯一字符串
mainBetRef	String(100)	主投注编号。仅红利投注编号
username	String(40)	下注的玩家名称
gamePeriodId	String(100)	本轮游戏Id
gameRoundId	String(100)	每轮游戏的轮数编号
gameType	String	已停止维护该参数，建议忽略注单游戏类别
currency	String(5)	请参考币别.
stake	decimal	玩家的投注金
turnoverStake	decimal	玩家的流水
orderDetail	String	下注内容
gameResult	String	本局游戏结果
winlostDate	dateTime	注单的归帐日。(格式为日期请忽略时间部分"00:00:00")(仅在注单结算后显示)
settleTime	DateTime	注单被结算的时间。若注单有被重新结算(won, lose, draw或void)，settleTime也会同步更新。
status	String	玩家的注单状态
winlost	decimal	玩家的注单净赢
gpId	int	游戏提供商的序号，请参考游戏提供商
topDownline	String	直屬下綫的用戶名/自己的用戶名如果注單是下綫的，會顯示屬於你直屬下綫的用戶名如果注單是自己的，會顯示自己的用戶名
gameId	int	游戏提供商的游戏序号, 请参考获取游戏列表 API
isGameProviderPromotion	bool	标记奖金由游戏提供商提供

范例


"result": [
    {
        "orderTime": "2020-03-25T21:27:53.58",
        "modifyDate": "0001-01-01T00:00:00",
        "settleTime": "2020-03-25T21:29:52.18",
        "refNo": "12213226",
        "mainBetRef": "12213223",
        "IsGameProviderPromotion": false,
        "username": "alextestAPI001",
        "gamePeriodId": "Funky_keno_710321",
        "gameRoundId": "Funky_keno_710321",
        "gameType": "FunkyGames_Atom",
        "stake": 5,
        "turnoverStake": 5,
        "orderDetail": "",
        "gameResult": "Funky_keno_710321",
        "winLostDate": "2020-03-25T00:00:00",
        "status": "lose",
        "winLost": -5,
        "topDownline": "YourApiDownline",
        "gpId": 16,
        "gameId": 16040001
    }
]

第三方体育注单列表

参数类型描述

refNo String(100) 投注编号

gpId

int

游戏提供商ID

gpId	Game provider	gpId	Game provider
44	Saba Sports

username String(40) 下注的玩家名称

productType String(50) 产品类别.可能值为 Sports / VirtualSports

orderTime DateTime 玩家下注的时间

winLostDate DateTime 注单的归帐日。(格式为日期请忽略时间部分"00:00:00")(仅在注单结算后显示)

settleTime DateTime 注单被结算的时间。若注单有被重新结算(won, lose, draw或void)，settleTime也会同步更新。

modifyDate DateTime 修改日期

odds decimal 下注的赔率

oddsStyle

String(5)

下注的赔率类别

M : Malay odds
        H : HongKong odds
        E : Euro odds
        I : Indonesia odds

stake decimal 玩家的投注金

actualStake decimal 玩家的实际投注金。在特别的下注赔率会与注金(stake)不同

currency String(5) 请参考币别.

status String(50) 玩家的注单状态

winlost decimal 玩家的注单净赢

turnover decimal 玩家的流水

maxWinWithoutActualStake decimal 注单未清算，将回传当前不包含注金(ActualStake)的最大净赢。
当注单清算时，将回传当前不包含注金(ActualStake)的预估净赢。

topDownline String 直屬下綫的用戶名/自己的用戶名
如果注單是下綫的，會顯示屬於你直屬下綫的用戶名
如果注單是自己的，會顯示自己的用戶名

turnoverByStake decimal 依据投注额的总投注流水

turnoverByActualStake decimal 依据有效投注额的总投注流水

netTurnoverByStake decimal 依据投注额的淨投注流水

netTurnoverByActualStake decimal 依据有效投注额的淨投注流水

subBet List of Object 注单的子注单

Sample


"result": [
    {
        "subBet": [
        {
            "betOption": "over ",
            "marketType": "Over/Under",
            "sportType": "Soccer",
            "hdp": 3.75,
            "odds": 0.92,
            "league": "TESTING (Betting Prohibited Area!!) - Betradar Test - SOCCER",
            "match": "Test D vs Test O",
            "status": "Running",
            "winlostDate": "2023-01-09T00:00:00",
            "liveScore": "0:0",
            "settlementTime": "2023-01-09T04:04:46.407"
        }
        ],
        "productType": "Sports",
        "odds": 0.92,
        "oddsStyle": "Malay",
        "actualStake": 1,
        "turnover": 1,
        "turnoverByStake": 1,
        "turnoverByActualStake": 1,
        "netTurnoverByStake": 0,
        "netTurnoverByActualStake": 0,
        "maxWinWithoutActualStake": 0.92,
        "orderTime": "2023-01-09T04:04:36.723",
        "modifyDate": "2023-01-09T06:45:10.117",
        "settleTime": "2023-01-09T04:04:48.317",
        "winLostDate": "0001-01-01T00:00:00",
        "refNo": "SabaSeamlessWallet_2697_4252700_1781_U",
        "username": "testuser",
        "currency": "USD",
        "stake": 1,
        "winLost": 0,
        "status": "running",
        "topDownline": null
    }
]

第三方体育博彩注单明细

参数	类型	描述
betOption	String(150)	会员在此投注中选择的选项
sportType	String(50)	运动类型
marketType	String(1250)	盘口的类型
hdp	decimal	下注选项的让球数
odds	decimal	下注选项的赔率
league	String(150)	本场赛事的联赛名称
match	String(350)	赛事的名称
status	String(50)	注单的状态
winLostDate	DateTime	注单的归帐日。(格式为日期请忽略时间部分"00:00:00")(仅在注单结算后显示)
liveScore	String(20)	如果为滚球赛事，将记录玩家下注时的比分
settlementTime	DateTime	注单的结算时间
isLive	bool	是否为滚球投注

Sample


{
    "betOption": "Over",
    "sportType": "Soccer",
    "marketType": "Over/Under",
    "hdp": 0.0,
    "odds": 0.8,
    "league": "FINLAND YKKONEN",
    "match": "Vaasa VPS vs FC KTP",
    "status": "lose",
    "winlostDate": "2020-01-01T00:00:00",
    "liveScore": "1:0",
    "settlementTime": "2020-01-01T22:34:46.03",
    "isLive": false
}

9.10 体育注单限额相关

玩家注单限额由以下三种资料决定

类型	描述
Match Limit	每场赛事的下注限制，由Trader控制。
Player Bet Setting	每个会员的下注限制，由代理控制。
Currency Limit	每种币别的下注限制，由568win系统控制。

最低限额/最高限额

类型	描述	范例
Min Bet	如果下注金低于货币限制，它将选择货币与会员限制之中较大的值。	Currency limit : Min. bet = 15 Player limit : Min. bet = 10 Then the Min. bet that player will see on the ticket is 15.
Max Bet	会受到很多条件的影响，如下所示： - 赔率 Max. (由Trader控制) - 赛事Max. (由Trader控制) - 会员 Max. 多数的时间由Trader决定，但它不会超过会员最多的设置。	货币限制: Max. bet = 15000 会员限制: Max. bet = 10000 会员将会看到注单的Min. bet为10000。

9.11 注单状态

状态	描述
draw	该笔投注为和局。
lose	该笔投注为输，损失金额将从玩家帐户中扣除。
refund	退款投注是指退还投注金额的投注。
running	投注已被接受，等待结算。
void	无效投注会发生在多种情况下，投注将不予计算。当投注被宣布无效时，玩家的投注金将被退回。
waiting	滚球投注正在处理中，但尚未被接受。
waiting Rejected	在多种可能情况下，玩家投注后，操盘手会拒绝投注，例如即将进球、自由球... 等情况。
won	该笔投注为赢，已将赢注金额派彩至玩家账户。
done	當串关子注单退还投注金额，既该子注单状态显示为‘Done’。
VOID(SUSPENDED MATCH)	当混合过关的子注单因赛事而suspended，该子注单状态显示为‘VOID(SUSPENDED MATCH)’。
Bonus	红利注单，奖金将派彩至玩家账户。仅有部分无缝游戏(第三方游戏) 提供红利注单。部分无缝游戏(第三方游戏) 有以红利状态发送赢注派彩，例如 Microgaming。

9.13 游戏提供商游戏类别
(停止维护，请使用9.13.1 游戏提供商新游戏类别來代替)

资料形态	描述
0	未知
1	线上赌场
2	老虎机
3	桌上游戏
4	刮奖卡
5	猜大小&数字游戏
6	鱼机&街机
7	虚拟游戏
8	其他游戏
9	大厅
10	体育

9.13.1 游戏提供商新游戏类别

资料形态	描述
0	UnKnown
100	Casino Lobby
101	Baccarat
102	Blackjack
103	Roulette
104	Dragon Tiger
105	Sicbo
106	Bull Bull
107	Poker
108	Dice
109	Game Show
200	Games Lobby
201	Slots
202	Arcade Games
203	Fishing Games
204	Table Games
205	Scratchcards
206	Virtual Games
207	Lottery Games
208	Other Games
300	Sportsbook

9.14 第三方体育运动类型

游戏提供商

描述

SABA Sports

Sport Type	描述
1	足球
2	篮球
3	美式足球
5	网球
8	棒球
10	高尔夫球
11	赛车
43	电子竞技
99	其他
180	虚拟足球虚拟网球虚拟赛马(暂时关闭) 虚拟赛狗(暂时关闭) 虚拟沙地摩托车(暂时关闭) 虚拟赛车(暂时关闭) 虚拟自行车(暂时关闭)
190	虚拟足球联赛虚拟足球国家杯虚拟足球世界杯虚拟篮球虚拟足球亚洲杯 Virtual Soccer English Premier 虚拟足球冠军杯虚拟足球欧洲杯 Virtual Sports Parlay
9901	沙巴足球
9902	沙巴篮球
1MP	足球串关
99MP	串关

568WIN v2.9.63

1.API 概况

1.1 免责声明

1.2 概况

1.3 流程图

1.4 API 协议

1.5 更新日誌

2.代理 API

2.1 注册代理

请求

回应

2.2 更新代理状态

请求

回应

2.3 修改代理预设下注设定

请求

回应

2.4 根据运动与盘口修改代理预设下注设定

请求

回应

2.4.1 修改代理在第三方体育预设下注设定

请求

回应

3.会员 API

3.1 注册会员

请求

回应

3.2 登入

请求

回应

3.3 导页至 SBO 体育博彩

参数

3.3.1 导页至568Win体育博彩

参数

3.4 导页至 SBO 体育博彩WAP版

参数

3.5 导页至 568Win 真人赌场

参数

3.6 导页至 SBO 电子游戏

参数

3.7 导页至 SBO 虚拟体育

参数

3.8 导页至无缝游戏（第三方游戏）

参数

第三方资讯(支援币别，注单相关资讯)

3.8.1 导页至第三方体育

参数

3.9 更新会员状态

请求

回应

3.10 会员存款

请求

回应

3.11 会员提款

请求

回应

3.12 查询存提款交易状态

请求

回应

3.13 获取会员余额

请求

回应

3.14 登出会员

请求

回应

3.15 更新会员下注设定

请求

回应

3.16 根据运动以及盘口更新会员在白牌系统的下注设定。

请求

回应

3.16.1 修改玩家在第三方体育预设下注设定

请求

回应

3.17 根据运动类型和盘口获取会员的下注设定

请求

回应

3.18 更新会员UserGroup

请求

回应