Golden 777 soft
目录
更新记录
| 版本 | 更新日期 | 描述 |
| 1.0.0 | 2024-10-08 | 修订文件初版 |
| 1.0.1 | 2024-12-30 | 卡尔更新代码细节 |
| 1.0.2 | 2026-06-28 | 新增单一钱包接口 |
1.1,文档目的:本API对接文档用于指导运营商如何正确集成游戏API,以实现与游戏平台的无缝对接。
本文档介绍转账模式的对接方式。所谓转账模式,即指玩家需要从玩家钱包将金额转账至
G7S 游戏系统钱包才可进行游戏。这也表示,玩家需将盈利的金额从 G7S 游戏系统钱
包转账至中心钱包后才可进行提款。
2.1,游戏尺寸要求
G7S游戏以 H5 制作并有横版竖版两种方式呈现,在尺寸规格上有最低要求。有关 iframe 中的
游戏尺寸,请参阅以下内容:
• 横版尺寸 : 1280 x 720
• 竖版尺寸 : 720 x 1280
2.2,硬件
| Android | iOS | Windows | |
| 操作系统版本 | 8.1或以上 | 14.0或以上 | 7或以上 |
| 内存 | 2GB | 2GB | 2GB |
| 中央处理器 | ARM Cortex-A9 或以上 |
iPhone 8或以上 | • 1 千兆赫 (GHz) 或更快 • 基于 32-bit (x86) 或 64- bit (x64) 处理器 • 至少双核 |
| 储存 | 2GB 和以上 | 2GB 和以上 | 2GB 和以上 |
2.3,浏览器
• Microsoft Edge : 版本 79 或更高版本
• Google Chrome : 版本 59 或更高版本
• Safari : 版本 11.1 或更高版本
• 其他 : 基于 Chromium 的浏览器需同等于 Google Chrome 59 或更高版本
2.4,不支持的浏览器
• Android : 火狐浏览器及 CM 浏览器
• iOS : CM 浏览器
• 桌面 : UC 浏览器、百度浏览器、夸克浏览器、 CM 浏览器、IE 浏览器
API功能简述:API让您得以通过编程方式使用G7S工具和服务。您可以通过这些 API检索信息,并创建、修改或删除G7S所提供的各种服务,例如创建游戏等。G7S的API皆按服务划分。每种服务在本文档中都有个别的章节。本文档所包含的所有API 都是可选的,运营商可依据需求选择API对接。
3.1,游戏登录方式
G7S 支持URL scheme模式登录授权方式:
• URL scheme模式适用于 iOS、Android 和浏览器,它使用令牌参数进行登录;
3.1.1 URL Scheme 方式
URL scheme 模式是游戏启动的常规方法。 玩家需要通过运营商的网站或App登录,并通过运营商的游戏大厅页面启动游戏。
注解:
● 运营商需提供登录页面(运营商服务器主控)以供玩家登录。
● 当玩家成功登录时,运营商需调用G7S游戏登录API
● 运营商需提供令牌验证API ,并用于运营商玩家令牌的身份验证。
登录流程
运营商需提供一个登录页面,玩家登录成功后选择G7S平台通过API接口创建玩家账号和获取最新游戏列表,获取游戏列表成功之后玩家根据喜好选择进入G7S游戏,进入G7S游戏之前要先进行钱包转入操作,运营商平台金额转入G7S后调用创建游戏API登录G7S游戏。
3.2,游戏登录限制
G7S游戏不支持一个账号多重登录或一个玩家同时打开多个游戏。以上操作将导致玩家被 锁定,同时将被踢出游戏及报错:
4.1请求参数
该 API 使用 HTTP 表单方式以及 RESTful 终点架构。运营商需根据以下内容格式发送请求:Content-Type: application/json
4.2请求方法:POST
4.3 签名:
要求运营商使用约定的密钥进行哈希校验,使用HAMAC-SHA256算法生成token。
例如trace_id=8431207b-6af0-4526-9409-037d8af625b2&access_id=f5595ea286dad2f91816f0b9&access_key=a1b25cde5f3gh46dijkdl&username=test123&nickname=test123
哈希校验之后的token:
c5bfe2c78ff0ce1538838e5d95dabac7eac61b278dda1a7b86d45bf7df69279b
之后数据为:trace_id=8431207b-6af0-4526-9409-037d8af625b2&access_id=f5595ea286dad2f91816f0b9&access_key=a1b25cde5f3gh46dijkdl&username=test123&nickname=test123&access_token=c5bfe2c78ff0ce1538838e5d95dabac7eac61b278dda1a7b86d45bf7df69279b
4.4 数据加密
为保证运营商和G7S数据传输安全性,我们建议对数据进行AES加解密,AES密钥和运营商约定。如上面签名之后的数据AES加密后为:1hVqPUFHOX4g4BMt4j076gpkup9z+O5VUe1qtUeAOup04ACHaaXSb0qH69ObzydN1248PvfJVCaGiWzk2XXOD4UATqLTxEpzAl1OUB6/k9Xr/LFmS0Dq0zc9NUnBdpl/ZmSITizzaEw02DjASoIoSnInfUiccakP4zS1rbPXsjFx2FZXDZzGKnVv3kxHseHMlF0pSAa3UGeh6efIKUQuX/2CWEtynPLyYTFy/3TcAd1mTEev9HmoSuzq+tySpnmmoV3dPyLPSNPcrlNikRgB7S1favNOyMlBkoZjeLM3bUQkDndKWnOoLZjoUaoANA4f
4.5 返回结果
API 返回 JSON 格式的返回结果。对于成功和失败的 API 请求,G7S将会返回 HTTP 状态码为 200 的 API 返回结果。API 对于全部 API 方式都使用全球 JSON 格式的返回结果,其内容类型如下:Content-Type: application/json
参数:error_code [错误提示码]
message [提示信息]
data [API返回信息,json格式将会依据各个API而有所不同]
例子:
成功的返回结果
{
"error_code":0,
"message":"success",
"data": {
[API method response. JSON object format may vary depending on API methods]
}
}
失败/错误的返回结果
{
"error_code": "[Error code]",
"message": "[Error message]" ,
"data": null
}
在G7S游戏系统中创建新玩家帐户
请求参数
API URL: {G7SSoftAPIDomain}/api/login/api_login
| 参数名称 | 数据类型 | 必需项 | 描述 |
| access_token | string | ● | 商户号 |
| access_key | string | ● | 和运营商约定的密钥 |
| user_id | string | ● | 用户ID(唯一标识符) |
| device_type | Tinyint | 设备类型 16-安卓 32-ios 64-h5 |
例子:
返回结果
{
"status": 200,
"message": "",
"data": {
"userID": 79818,
"nickName": "696246",
"faceID": 2,
"userScore": 0,
"inGameData": [],
"uid": "4A4B5BAC-7383-11F1-9890-02FFF96D2257",
"idx": "",
"time": 1782714444,
"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJzbG90IiwiYXVkIjoic2xvdCIsImlhdCI6MTc4MjcxNDQ0NCwibmJmIjoxNzgyNzE0NDQ0LCJkYXRhIjp7InVzZXJJRCI6Nzk4MTgsIkNoYW5uZWxJRCI6MzAwMzZ9fQ.rkFjf4-wzA4EXO3M7R16oZBq56wVgRmL9KvqcPD9mwQ",
"free_status": 1,
"cj_show": 0,
"systemMsgPush": 0,
"exchange_rate": "1.00"
},
"result": {
"AgentID": 0,
"score": 1,
"RegisterMobile": "",
"newUser": 0,
"systemMsgPush": 0,
"cj_show": 0
}
}
获取已经开放的游戏列表。
请求参数
API URL: {G7SSoftAPIDomain}/api/game_list
HTTP 方法 : POST
返回结果
{
"status": 200,
"message": "",
"data": {
"ip_list": [
"8.218.254.76"
],
"hot": [
[
9021,
4,
[
[
0,
9021,
0,
53
]
],
0,
"",
"http://qweosss.oss-us-east-1.aliyuncs.com/pro/002Beta/game_icon/yolo/dt_game_b9021.png"
],
[
9117,
4,
[
[
0,
9117,
0,
300
]
],
0,
"",
"http://qweosss.oss-us-east-1.aliyuncs.com/pro/002Beta/game_icon/yolo/dt_game_b9117.png"
]
[
9063,
4,
[
[
0,
9063,
0,
98
]
],
0,
"",
"http://qweosss.oss-us-east-1.aliyuncs.com/pro/002Beta/game_icon/yolo/dt_game_b9063.png"
],
[
9090,
4,
[
[
0,
9090,
0,
109
]
],
0,
"",
"http://qweosss.oss-us-east-1.aliyuncs.com/pro/002Beta/game_icon/yolo/dt_game_b9090.png"
],
[
9091,
4,
[
[
0,
9091,
0,
120
]
],
0,
"",
"http://qweosss.oss-us-east-1.aliyuncs.com/pro/002Beta/game_icon/yolo/dt_game_b9091.png"
],
[
5006,
8,
[
[
0,
5006,
0,
194
]
],
0,
"",
"http://qweosss.oss-us-east-1.aliyuncs.com/pro/002Beta/game_icon/yolo/dt_game_b5006.png"
],
[
5013,
8,
[
[
0,
5013,
0,
237
]
],
0,
"",
"http://qweosss.oss-us-east-1.aliyuncs.com/pro/002Beta/game_icon/yolo/dt_game_b5013.png"
]
]
},
"result": []
}
登录G7S游戏。
请求参数
API URL: {G7SSoftAPIDomain}/api/index/get_game_url
HTTP 方法 : POST
主体参数
| 参数名称 | 数据类型 | 必需项 | 描述 |
| user_id | Int | ● | 登录接口返回的userid |
| game_id | Int | ● | 游戏列表返回的game_id |
| token | string | ● | 登录接口返回的token |
| score | Float | ● | 用户分数 |
例子:
参数:
{
"user_id":79818,
"game_id":3006,
"token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJzbG90IiwiYXVkIjoic2xvdCIsImlhdCI6MTc4MzQ3ODQyNiwibmJmIjoxNzgzNDc4NDI2LCJkYXRhIjp7InVzZXJJRCI6Nzk4ODgsIkNoYW5uZWxJRCI6MzAwMzZ9fQ.0Zf3RltrPhqEdImnZC68D0JgIx_lZ89zHw3RnoazfPw",
"score":100
}
返回结果
主体参数:JSON对象
| 参数名 | 数据类型 | 描述 |
| error_code | integer | 错误号 |
| data | string | 游戏跳转URL |
示例:
{
"status": 200,
"message": "",
"data": "https://yoloh5.play8.cyou/play85/?UserID=79818&token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJzbG90IiwiYXVkIjoic2xvdCIsImlhdCI6MTc4MzQ3ODQyNiwibmJmIjoxNzgzNDc4NDI2LCJkYXRhIjp7InVzZXJJRCI6Nzk4ODgsIkNoYW5uZWxJRCI6MzAwMzZ9fQ.0Zf3RltrPhqEdImnZC68D0JgIx_lZ89zHw3RnoazfPw&ChannelID=30036&userGUID=4A4B5BAC-7383-11F1-9890-02FFF96D2257&GameID=3006&ServerID=11&ServerAddr=8.218.254.76&serverPort=3006&lang=en&apiType=1&backUrl=&score=100",
"result": []
}
充值现金至特定玩家的现金钱包。
注解:
• transaction_ticket是每笔交易的唯一识别码。运营商需要为每笔传送请求发送新的识别码
• 对于重复请求,G7S不对玩家钱包余额进行任何操作,但返回转账成功的响应。
请求参数
API URL: {G7SSoftAPIDomain}/api/bet_record
HTTP 方法 : POST
主体参数
| 参数名称 | 数据类型 | 必需项 | 描述 |
| token | ● | 登录接口返回的 | |
| user_id | ● | 登录接口返回的 | |
| Date | ● | 日期1-今日 2-昨日 3-近7日 4- 近15日 5-本月 |
例子:
参数:
{
"token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJzbG90IiwiYXVkIjoic2xvdCIsImlhdCI6MTc4MzQ3ODQyNiwibmJmIjoxNzgzNDc4NDI2LCJkYXRhIjp7InVzZXJJRCI6Nzk4ODgsIkNoYW5uZWxJRCI6MzAwMzZ9fQ.0Zf3RltrPhqEdImnZC68D0JgIx_lZ89zHw3RnoazfPw",
"user_id":79818,
"date":1
}
返回结果
主体参数:JSON对象
示例:
{
"status": 200,
"message": "",
"data": {
"total_page": 0,
"total_record": 0,
"sum_flow": 0,
"sum_winlose": 0,
"records": [],
"games": [
{
"KindID": 3002,
"ClientID": 68
},
{
"KindID": 9251,
"ClientID": 1332
}
]
},
"result": []
}
将特定玩家的现金钱包的余额转出。
注解:
• transaction_ticket是每笔交易的唯一识别码。运营商需要为每笔传送请求发送新的识别码
• 对于重复请求,G7S不对玩家钱包余额进行任何操作,但返回转账成功的响应。
请求参数
API URL: {G7SSoftAPIDomain}/v1/Transfer/TransferOut
HTTP 方法 : POST
主体参数
| 参数名称 | 数据类型 | 必需项 | 描述 |
| trace_id | string | ● | 请求的唯一标识符(如GUID,时间戳(毫秒级)) |
| access_id | string | ● | 运营商的唯一标识符 |
| access_token | string | ● | 签名 |
| access_key | string | ● | 和运营商约定的密钥 |
| username | string | ● | 玩家账号(唯一标识符) |
| transaction_ticket | string | ● | 交易凭证,运营商平台生成并确保每 次交易是独有的。 注: 上限 50 字符 |
| amount | decimal | ● | 转账金额(小数点后两位) 注: 最低 0.01 |
例子:
参数:
trace_id=f4f1445e-1411-43fc-abc2-a69954850658&access_id=f5595ea286dad2f91816f0b9&access_key=a1b25cde5f3gh46dijkdl&username=test123&transaction_ticket=T20250111104947Utest123&amount=99.99
哈希校验之后:
trace_id=f4f1445e-1411-43fc-abc2-a69954850658&access_id=f5595ea286dad2f91816f0b9&access_key=a1b25cde5f3gh46dijkdl&username=test123&transaction_ticket=T20250111104947Utest123&amount=99.99&access_token=8768e833193ce41f88d171a2f5b90710cc21ad3700eedd51a841da026f9b6bcf
URL:
https://api.g7s-bo.me/v1/Transfer/TransferOut?data=LF3J7rHoTZTEo9HpqLI+58+yMfgpmbzlTODWgV1lJsIyMlvlHB2hCloT2YTmCdby1248PvfJVCaGiWzk2XXOD4UATqLTxEpzAl1OUB6/k9Xr/LFmS0Dq0zc9NUnBdpl/ZmSITizzaEw02DjASoIoSnInfUiccakP4zS1rbPXsjFmaSFV8FZQBhp4BCf3gTc1Uw/LXUL6Eb2Xh6nWeAFbcAtHMKRX2Hr/1GZkIy2akf/dbwDeT3HFyR6MvGaW+/WbGAneo7XPhjz7F83QWr2ECFbAzchRLTL5KGUIuHSQ215FPMa37vY9uaCVyJWL4jDKnIMcumCLwnzHKYxvAH0L9Die3lw9xFIdcexLKPb8PSQ=
返回结果
主体参数:JSON对象
| 参数名 | 数据类型 | 描述 |
| error_code | integer | 错误号 |
| transaction_id | string | 交易编号 |
| balance_before | decimal | 交易前的玩家余额 |
| balance_after | decimal | 交易后的玩家余额 |
| amount | decimal | 交易金额 |
示例:
{
"error_code":0,
"message":"success",
"data":
{
"transaction_id":"T20250111112505Utest123",
"balance_before":94.19,
"balance_after":0,
"amount":94.19
}
}
将特定玩家的现金钱包的所有余额转出。
注解:
• transaction_ticket是每笔交易的唯一识别码。运营商需要为每笔传送请求发送新的识别码
• 对于重复请求,G7S不对玩家钱包余额进行任何操作,但返回转账成功的响应。
请求参数
API URL: {G7SSoftAPIDomain}/v1/Transfer/TransferAllOut
HTTP 方法 : POST
主体参数
| 参数名称 | 数据类型 | 必需项 | 描述 |
| trace_id | string | ● | 请求的唯一标识符(如GUID,时间戳(毫秒级)) |
| access_id | string | ● | 运营商的唯一标识符 |
| access_token | string | ● | 签名 |
| access_key | string | ● | 和运营商约定的密钥 |
| username | string | ● | 玩家账号(唯一标识符) |
| transaction_ticket | string | ● | 交易凭证,运营商平台生成并确保每 次交易是独有的。 注: 上限 50 字符 |
例子:
参数:
trace_id=e62b56cf-f723-4147-84ae-035e881a2aab&access_id=f5595ea286dad2f91816f0b9&access_key=a1b25cde5f3gh46dijkdl&username=test123&transaction_ticket=T20250111111329Utest123
哈希校验之后:
trace_id=e62b56cf-f723-4147-84ae-035e881a2aab&access_id=f5595ea286dad2f91816f0b9&access_key=a1b25cde5f3gh46dijkdl&username=test123&transaction_ticket=T20250111111329Utest123&access_token=b2ee76d822e3107f3197f1f54c3e6fbecc5254d0ee4507d6da7ce4b461457374
URL:
https://api.g7s-bo.me/v1/Transfer/TransferAllOut?data=PH6opbqltUh1fAirc+6q/BiAWNthU6Cv2hx2WiOhyAa2jIXcEc7ob0tRIY71bSRq1248PvfJVCaGiWzk2XXOD4UATqLTxEpzAl1OUB6/k9Xr/LFmS0Dq0zc9NUnBdpl/ZmSITizzaEw02DjASoIoSnInfUiccakP4zS1rbPXsjFmaSFV8FZQBhp4BCf3gTc1Uw/LXUL6Eb2Xh6nWeAFbcOAdSePL5N7uZY5QlN8/QnALljWTY57W1EH/j7rdPkh38FYiVAgzaorom98sOz2tXHkmoeAe3eLVG1FuNf1yLk6+9kmNhdGuvKEnqqFoMy0s3Wc8JGmKONIALeXoZztO+w==
返回结果
主体参数:JSON对象
| 参数名 | 数据类型 | 描述 |
| error_code | integer | 错误号 |
| transaction_id | string | 交易编号 |
| balance_before | decimal | 交易前的玩家余额 |
| balance_after | decimal | 交易后的玩家余额 |
| amount | decimal | 交易金额 |
示例:
{
"error_code":0,
"message":"success",
"data":
{
"transaction_id":"T20250111111329Utest123",
"balance_before":99.99,
"balance_after":0,
"amount":99.99
}
}
获取特定玩家的现金钱包的余额。
请求参数
API URL: {G7SSoftAPIDomain}/v1/Transfer/BalanceQuery
HTTP 方法 : POST
主体参数
| 参数名称 | 数据类型 | 必需项 | 描述 |
| trace_id | string | ● | 请求的唯一标识符(如GUID,时间戳(毫秒级)) |
| access_id | string | ● | 运营商的唯一标识符 |
| access_token | string | ● | 签名 |
| access_key | string | ● | 和运营商约定的密钥 |
| username | string | ● | 玩家账号(唯一标识符) |
例子:
参数:
trace_id=9b6349dd-cc93-4dc7-af99-10fe8fd25905&access_id=f5595ea286dad2f91816f0b9&access_key=a1b25cde5f3gh46dijkdl&username=test123
哈希校验之后:
trace_id=9b6349dd-cc93-4dc7-af99-10fe8fd25905&access_id=f5595ea286dad2f91816f0b9&access_key=a1b25cde5f3gh46dijkdl&username=test123&access_token=1f49a16ce950ad10a65a61ef68fb81a55fcd592f909662949072a0d12b28d467
URL:
https://api.g7s-bo.me/v1/Transfer/BalanceQuery?data=oDLXZp5b9putE79ZR3PVmZ7Gtapp86PKAta/RDPWa7RIiGpN/Z/bcPWlinZYcpLG1248PvfJVCaGiWzk2XXOD4UATqLTxEpzAl1OUB6/k9Xr/LFmS0Dq0zc9NUnBdpl/ZmSITizzaEw02DjASoIoSnInfUiccakP4zS1rbPXsjHXpqMBouO9YN2IES5rGkqBwAsp0fAFDFjXEE2rBvOLJOtqQ7nlk+vdy4sRyKbfvxUnCOJuoQVRNRGd7pT0FMaJcHZZuhs6G3kST0eliN/MQ2sqyL4HWOWvtN6M73ZZH0I=
返回结果
主体参数:JSON对象
| 参数名 | 数据类型 | 描述 |
| error_code | integer | 错误号 |
| balance | decimal | 余额 |
示例:
{
"error_code":0,
"message":"success",
"data":
{
"balance":99.99
}
}
获取特定玩家投注历史记录:
请求参数API URL: {G7SSoftAPIDomain}/v1/History/GetHistory
HTTP 方法 : POST
主体参数
| 参数名称 | 数据类型 | 必需项 | 描述 |
| trace_id | string | ● | 请求的唯一标识符(如GUID,时间戳(毫秒级)) |
| access_id | string | ● | 运营商的唯一标识符 |
| access_token | string | ● | 签名 |
| access_key | string | ● | 和运营商约定的密钥 |
| username | string | ● | 玩家账号(唯一标识符) |
| begin_timestamp | integer | ● | 开始时间(Unix时间戳-世界标准时间 (UTC)) |
| end_timestamp | integer | ● | 结束时间(Unix 时间戳-世界标准时间 (UTC)) |
| row_count | integer | ● | 每批的记录数 注: 值度 1500 - 5000 |
| page_number | integer | ● | 页号 |
例子:
参数:
trace_id=9aec1529-5e92-499c-8bb0-cd4395ca0284&access_id=f5595ea286dad2f91816f0b9&access_key=a1b25cde5f3gh46dijkdl&username=test123&begin_timestamp=1736524800&end_timestamp=1736564029&row_count=20&page_number=0
哈希校验之后:
trace_id=9aec1529-5e92-499c-8bb0-cd4395ca0284&access_id=f5595ea286dad2f91816f0b9&access_key=a1b25cde5f3gh46dijkdl&username=test123&begin_timestamp=1736524800&end_timestamp=1736564029&row_count=20&page_number=0&access_token=bc282c48db72d3a649d01167b849d96d987fe0b54c38eb70246782caf047af0a
URL:
https://api.g7s-bo.me/v1/History/GetHistory?data=QyzhL+66teQh4oFqwQZLpzU3nqbabNk2k7jYZeb1pEZDEKObhrXjTLpcl3jue29e1248PvfJVCaGiWzk2XXOD4UATqLTxEpzAl1OUB6/k9Xr/LFmS0Dq0zc9NUnBdpl/ZmSITizzaEw02DjASoIoSnInfUiccakP4zS1rbPXsjFk8uY0hj/XnMG3LjziaujvocwgMfHLSVy0HOddHUjzCyZZanuhY78JYij12JXyJgV0RxouO+cJPrKdZwxnZ8eYWsakWj+GBekLuqskmLKGmTxEWWxPZGuat5ldoLt8DqxhBJ+YBi2wO5EC8J7bi7MLVuB7+cZ70PzZOjtRA6uMQ8BELg/w3/B+oQRpMYVn7ux74hZbhYeqqJ6qaQqDLcSd
返回结果
主体参数:JSON对象
| 参数名 | 数据类型 | 描述 |
| error_code | integer | 错误号 |
| game_id | integer | 游戏ID |
| bet_timestamp | integer | 下注时间(Unix时间戳) |
| bet_amount | decimal | 下注金额 |
| win_amount | decimal | 赢取金额 |
示例:
{
"error_code":0,
"message":"success",
"recordCount":2,
"data":[
{"game_id":9041,"bet_amount":3,"win_amount":0.2,"bet_timestamp":1736565891},
{"game_id":9041,"bet_amount":3,"win_amount":0,"bet_timestamp":1736565889} ]
}
获取特定玩家投注汇总:
请求参数API URL: {G7SSoftAPIDomain}/v1/History/GetHistorySummary
HTTP 方法 : POST
主体参数
| 参数名称 | 数据类型 | 必需项 | 描述 |
| trace_id | string | ● | 请求的唯一标识符(如GUID,时间戳(毫秒级)) |
| access_id | string | ● | 运营商的唯一标识符 |
| access_token | string | ● | 签名 |
| access_key | string | ● | 和运营商约定的密钥 |
| username | string | ● | 玩家账号(唯一标识符) |
| begin_timestamp | integer | ● | 开始时间(Unix时间戳-世界标准时间 (UTC)) |
| end_timestamp | integer | ● | 结束时间(Unix 时间戳-世界标准时间 (UTC)) |
| game_id | integer | ● | 游戏ID(注:0或者未指定表示所有游戏) |
例子:
参数:
trace_id=cb0b05bf-27ad-493d-a524-612c1cec13c0&access_id=f5595ea286dad2f91816f0b9&access_key=a1b25cde5f3gh46dijkdl&username=test123&begin_timestamp=1736524800&end_timestamp=1736564029
哈希校验之后:
trace_id=cb0b05bf-27ad-493d-a524-612c1cec13c0&access_id=f5595ea286dad2f91816f0b9&access_key=a1b25cde5f3gh46dijkdl&username=test123&begin_timestamp=1736524800&end_timestamp=1736564029&access_token=104b9ca0475de7db924713521826db04d6a65c0b0e1f26a721b49de25a992420
URL:
https://api.g7s-bo.me/v1/History/GetHistorySummary?data=sVBMvnsPQ8LWD/C67fLFI+fQrCJbA5Y8tPqDieuxw+7AHtjvnM1zPkW6hcxfQNri1248PvfJVCaGiWzk2XXOD4UATqLTxEpzAl1OUB6/k9Xr/LFmS0Dq0zc9NUnBdpl/ZmSITizzaEw02DjASoIoSnInfUiccakP4zS1rbPXsjFk8uY0hj/XnMG3LjziaujvocwgMfHLSVy0HOddHUjzCyZZanuhY78JYij12JXyJgVGtWJY57UaFXsMmoYvend0lIpTK0DOSxqs7lbDjJ/aWsC4amty447apsZvqTtcA9Ja+M5Lv6q5ueyakAe1uttEMcricxwNk9smyo3cr8+O6bs6nmDXcPh/AJRW9QLUcFM=
返回结果
主体参数:JSON对象
| 参数名 | 数据类型 | 描述 |
| error_code | integer | 错误号 |
| game_id | integer | 游戏ID |
| bet_amount | decimal | 下注金额 |
| win_amount | decimal | 赢取金额 |
示例:
{
"error_code":0,
"message":"success",
"data":{"bet_amount":6,"win_amount":-5.8,"game_id":0}
}
获取特定玩家钱包的转入转出记录:
请求参数API URL: {G7SSoftAPIDomain}/v1/Transfer/TransferHistory
HTTP 方法 : POST
主体参数
| 参数名称 | 数据类型 | 必需项 | 描述 |
| trace_id | string | ● | 请求的唯一标识符(如GUID,时间戳(毫秒级)) |
| access_id | string | ● | 运营商的唯一标识符 |
| access_token | string | ● | 签名 |
| access_key | string | ● | 和运营商约定的密钥 |
| username | string | ● | 玩家账号(唯一标识符) |
| begin_timestamp | integer | ● | 开始时间(Unix时间戳-世界标准时间 (UTC)) |
| end_timestamp | integer | ● | 结束时间(Unix 时间戳-世界标准时间 (UTC)) |
| row_count | integer | ● | 每批的记录数 注: 值度 1500 - 5000 |
| page_number | integer | ● | 页号 |
| operationType | integer | ● | 转账类型(0:全部,1:转入,2:转出) |
例子:
参数:
trace_id=9c91620f-d111-465d-a0b2-d07a5fa7ddd2&access_id=f5595ea286dad2f91816f0b9&access_key=a1b25cde5f3gh46dijkdl&username=test123&begin_timestamp=1736524800&end_timestamp=1736564201&row_count=20&page_number=0&operationType=0
哈希校验之后:
trace_id=9c91620f-d111-465d-a0b2-d07a5fa7ddd2&access_id=f5595ea286dad2f91816f0b9&access_key=a1b25cde5f3gh46dijkdl&username=test123&begin_timestamp=1736524800&end_timestamp=1736564201&row_count=20&page_number=0&operationType=0&access_token=36f63c195ea4bf3c5e31b1c5aa3294a0265402c30ccf45d18da20e4b2a119100
URL:
qCzrQqQjcIV3KXwqAfYGSUYIi/OrrqhxUBFZXfH1DAvsA6AFxUwl0iIjmTc4iGsc1248PvfJVCaGiWzk2XXOD4UATqLTxEpzAl1OUB6/k9Xr/LFmS0Dq0zc9NUnBdpl/ZmSITizzaEw02DjASoIoSnInfUiccakP4zS1rbPXsjFk8uY0hj/XnMG3LjziaujvocwgMfHLSVy0HOddHUjzCyZZanuhY78JYij12JXyJgV50rxINKZSylNa6A020eVFWsakWj+GBekLuqskmLKGmZf7KHIy1XrtUeINcrIzsIys3eBVzycUoSdCnMAr5edzx39Xw+Xrm7n3wqd/MbrrN4xCL7H50K83PS1OY33oYrzc9Hx9ciBhyzuD+ZqqmwRKsbMxS9l6vKTgEVSZjQQDXw==
返回结果
主体参数:JSON对象
| 参数名 | 数据类型 | 描述 |
| error_code | integer | 错误号 |
| recordCount | integer | 记录数目 |
| Score | decimal | 转账金额 |
| OperationType | integer | 转账类型(1:转入,2:转出) |
| InsertTimestamp | integer | 转账时间(Unix时间戳-世界标准时间 (UTC)) |
示例:
{
"error_code":0,
"message":"success",
"recordCount":2,
"data":[
{"Score":99.99,"OperationType":1,"InsertTimestamp":1736565516},
{"Score":99.99,"OperationType":2,"InsertTimestamp":1736565209}
]
玩家每玩一局游戏都会调用运营商接口传递游戏输赢信息,需运营商提供接口存档数据:
HTTP 方法 : POST
主体参数
| 参数名称 | 数据类型 | 必需项 | 描述 |
| access_id | string | ● | 运营商的唯一标识符 |
| access_token | string | ● | 签名 |
| access_key | string | ● | 和运营商约定的密钥 |
| username | string | ● | 玩家账号(唯一标识符) |
| begin_timestamp | integer | ● | 开始时间(Unix时间戳-世界标准时间 (UTC)) |
| end_timestamp | integer | ● | 结束时间(Unix 时间戳-世界标准时间 (UTC)) |
| balance_amount_before | decimal | ● | 玩家余额(押注前) |
| game_id | integer | ● | 游戏ID |
| bet_amount | integer | ● | 押注金额 |
| win_amount | decimal | ● | 获利金额 |
例子:
参数:
access_id=f5595ea286dad2f91816f0b9&balance_amount_before=20.00&begin_timestamp=1736524800&username=test123&end_timestamp=1736564201&game_id=9010&bet_amount=0.10&win_amount=0.20&access_key=a1b25cde5f3gh46dijkdl
MD5校验之后:
access_id=f5595ea286dad2f91816f0b9&balance_amount_before=20.00&begin_timestamp=1736524800&bet_amount=0.10&end_timestamp=1736564201&game_id=9010&username=test123&win_amount=0.20&access_key=a1b25cde5f3gh46dijkdl&access_token=389f69b02e6833483e0e89c8e5ac04b1
返回结果
主体参数:string(数据合法校验通过则返回success,否则返回其它)
操作提示error_code为1003,请检查运营商标识符access_id填写是否正确。
操作提示error_code为1008,请检查API接口参数是否完整。
操作提示error_code为1009,请检查密钥是否正确,哈希校验生成的token是否正确。
钱包转出操作提示error_code为1015,message内容为“You are in the game, please end the game first”。可以调用踢出玩家(KickOut) API,将玩家从G7S游戏中退出就可以再次进行钱包转出操作。
示例
{
"error_code":1015,
"message":"You are in the game, please end the game first"
}
数据加密:建议运营商使用HTTPS加密数据传输,确保数据安全。
防重放攻击:建议使用时间戳或唯一标识符,防止重放攻击。
8.限制
8.1,IP限制
中国大陆地区的玩家将无法访问G7S游戏
8.2,货币限制
以下为不被 G7S 所支持的货币:
• HKD
• MOP
• MYR
• SGD
• TWD
• VES
• MBTC,UBTC,USDT,TUSD & USDC 除外的所有加密货
9.1,错误代码
| 错误号 | 错误描述 |
| 0 | 操作成功 |
| 1000 | 请求无效 |
| 1001 | 操作失败 |
| 1002 | 内部错误 |
| 1003 | 无效的运营商 |
| 1004 | 玩家账号已存在 |
| 1005 | 玩家正在进行另一项操作,请稍后再试 |
| 1006 | 玩家账号不存在 |
| 1007 | 玩家已锁定 |
| 1008 | 参数不全 |
| 1009 | 签名无效 |
| 1010 | 钱包转账金额低于最低值 |
| 1011 | 帐号关闭 |
| 1012 | 重复操作 |
| 1013 | 钱包余额不足,转出失败 |
| 1014 | 游戏维护中,请稍等再试 |
| 1015 | 玩家正在游戏中,请先退出游戏 |
9.2,货币代码
| 货币代码 | 描述 |
| $ | 美金 |
| ¥ | 人民币 |
9.3,平台
| 代码 | 类型 | 平台 |
| 1 | 网页端 | Windows |
| 2 | Macos | |
| 3 | Android | |
| 4 | ios | |
| 5 | 其他 | |
| 6 |
9.4,语言
| 代码 | 描述 |
| en | 英语 |
| tc | 繁体中文 |
| pt | 葡萄牙语 |
| vn | 越南语 |
| idn | 印度尼西亚语 |
| esp | 西班牙语 |