G7S API 对接文档

G7S API 对接文档

• API对接文档

• 1. 文档概述

• 2. 系统要求

• 3. 游戏启动

• 对接API

• API接口

• 错误处理

• 7. 安全建议

• 9. 附录

Golden 777 soft

API对接文档

目录

API对接文档 1

1. 文档概述 2

2. 系统要求 2

3. API概述 3

4. 对接API 3

5. API功能模块 4

6. 错误处理 4

7. 安全建议 5

8. IP限制 5

9 附录 6

更新记录

1. 文档概述

1.1，文档目的：本API对接文档用于指导运营商如何正确集成游戏API，以实现与游戏平台的无缝对接。

本文档介绍转账模式的对接方式。所谓转账模式，即指玩家需要从玩家钱包将金额转账至

G7S 游戏系统钱包才可进行游戏。这也表示，玩家需将盈利的金额从 G7S 游戏系统钱

包转账至中心钱包后才可进行提款。

2. 系统要求

2.1，游戏尺寸要求

G7S游戏以 H5 制作并有横版竖版两种方式呈现，在尺寸规格上有最低要求。有关 iframe 中的

游戏尺寸，请参阅以下内容：

• 横版尺寸 : 1280 x 720

• 竖版尺寸 : 720 x 1280

2.2，硬件

2.3，浏览器

• Microsoft Edge : 版本 79 或更高版本

• Google Chrome : 版本 59 或更高版本

• Safari : 版本 11.1 或更高版本

• 其他 : 基于 Chromium 的浏览器需同等于 Google Chrome 59 或更高版本

2.4，不支持的浏览器

• Android : 火狐浏览器及 CM 浏览器

• iOS : CM 浏览器

• 桌面 : UC 浏览器、百度浏览器、夸克浏览器、 CM 浏览器、IE 浏览器

3. 游戏启动

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游戏不支持一个账号多重登录或一个玩家同时打开多个游戏。以上操作将导致玩家被 锁定，同时将被踢出游戏及报错：

对接API

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

签名代码：
function createSign($data,$key)
{
ksort($data);
$strSign='';
foreach ($data as $k => $v) {
if($k=='sign') continue;
if($v===null || $v==='') continue;
if(is_array($v)) $v = json_encode($v);
$strSign .= $k . '=' . $v . '&';
}
$strSign = trim($strSign,'&');
return md5($strSign.'&key='.$key);
}

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

}

API接口

正式服域名：https://apis.luckyvegasvip.com

创建玩家

在G7S游戏系统中创建新玩家帐户

请求参数

API URL: {G7SSoftAPIDomain}/api/login/api_login

例子：

返回结果

{

    "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

    }

}

5.2踢出玩家

将玩家从G7S游戏中踢出，玩家仍然可以重新登录游戏。

请求参数

API URL: {G7SSoftAPIDomain}/v1/Player/KickOut

HTTP 方法 : POST

主体参数

例子：

参数：

trace_id=dcea4ca3-d07d-462c-9efc-2562d4ec48a1&access_id=f5595ea286dad2f91816f0b9&access_key=a1b25cde5f3gh46dijkdl&username=test123

哈希校验之后:

trace_id=dcea4ca3-d07d-462c-9efc-2562d4ec48a1&access_id=f5595ea286dad2f91816f0b9&access_key=a1b25cde5f3gh46dijkdl&username=test123&access_token=a9b1922926bc0e70c418b300e6e2f064925b06303f1cd2da596fedf815b2d6bf

URL:

https://api.g7s-bo.me/v1/Player/KickOut?data=KvUwBN6jKu3gBRUqwLTwu205JFvc0nF/bemPTvRGqESlthnSAjdsebZXm9Uk+mQJ1248PvfJVCaGiWzk2XXOD4UATqLTxEpzAl1OUB6/k9Xr/LFmS0Dq0zc9NUnBdpl/ZmSITizzaEw02DjASoIoSnInfUiccakP4zS1rbPXsjHXpqMBouO9YN2IES5rGkqB53mKlrAqvQUfqrrJ/2+e0sVoBOEHSNDwfhRbk3S91I89iVhoY8xUTXyrUjXkbHQq4mZVEJCBbwoHbJfpx1nrimsqyL4HWOWvtN6M73ZZH0I=

返回结果

主体参数：JSON对象

示例：

{

"error_code":1001,

"message":"fail"

}

5.3游戏列表

获取已经开放的游戏列表。

请求参数

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": []

}

5.4创建游戏

登录G7S游戏。

请求参数

API URL: {G7SSoftAPIDomain}/api/index/get_game_url

HTTP 方法 : POST

主体参数

例子：

参数：

{

    "user_id":79818,

    "game_id":3006,

    "token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJzbG90IiwiYXVkIjoic2xvdCIsImlhdCI6MTc4MzQ3ODQyNiwibmJmIjoxNzgzNDc4NDI2LCJkYXRhIjp7InVzZXJJRCI6Nzk4ODgsIkNoYW5uZWxJRCI6MzAwMzZ9fQ.0Zf3RltrPhqEdImnZC68D0JgIx_lZ89zHw3RnoazfPw",

    "score":100

}

返回结果

主体参数：JSON对象

游戏跳转 URL 字段：

bgUrl：加载图页面，可替换为自己的加载图页面 URL。

isOpenKickOut：是否开启踢出游戏，1开，0关。

sound：1开，0关，默认0。

lang：多语言，默认en。多语言查看9.4。

loadType：游戏加载页面类型。

loadType=1：直接进入游戏加载页面，进度条无倒计时。

loadType=2：直接进入游戏加载页面，进度条有倒计时。

示例：

{

    "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&apiScreen=1&isOpenKickOut=1&bgUrl=https://ddd&sound=0&loadType=2",

    "result": []

}

5.5钱包转入

充值现金至特定玩家的现金钱包。

注解：

• transaction_ticket是每笔交易的唯一识别码。运营商需要为每笔传送请求发送新的识别码

• 对于重复请求，G7S不对玩家钱包余额进行任何操作，但返回转账成功的响应。

请求参数

API URL: {G7SSoftAPIDomain}/v1/Transfer/TransferIn

HTTP 方法 : POST

主体参数

例子：

参数：

trace_id=5aab853b-dcfb-463d-82c5-b1b45bb678c2&access_id=f5595ea286dad2f91816f0b9&access_key=a1b25cde5f3gh46dijkdl&username=test123&transaction_ticket=T20250111104037Utest123&amount=100

哈希校验之后:

trace_id=5aab853b-dcfb-463d-82c5-b1b45bb678c2&access_id=f5595ea286dad2f91816f0b9&access_key=a1b25cde5f3gh46dijkdl&username=test123&transaction_ticket=T20250111104037Utest123&amount=100&access_token=b2bd18022984d905e29293dee5df1bde911f9d98d75328de384a189f8c054cb8

URL:

https://api.g7s-bo.me/v1/Transfer/TransferIn?data=yfDTIJFyP+a/5EZNRm+7htPLBpc4xwilkybwsDsIMDGYzeoI3Cu6RNKQ3BodUuIo1248PvfJVCaGiWzk2XXOD4UATqLTxEpzAl1OUB6/k9Xr/LFmS0Dq0zc9NUnBdpl/ZmSITizzaEw02DjASoIoSnInfUiccakP4zS1rbPXsjFmaSFV8FZQBhp4BCf3gTc1Uw/LXUL6Eb2Xh6nWeAFbcBcU3F4tv9fFYGMg3Rj2K9kU/ZSSpeiTxYe4GcqXkYAxelviZFhzMP+fldNkQpbWtQe4gPGquFS9wbU5NwxcEd2nUMiW0HmSWw+Mcp9+dwj4Wfr3VT7RRg7NA+k+eH1imG9voqHhwzk70xHO0UaANTA=

返回结果

主体参数：JSON对象

示例：

{

"error_code":0,

"message":"success",

"data":

{

"transaction_id":"T20250111112429Utest123",

"balance_before":0,

"balance_after":99.99,

"amount":99.99

}

}

5.6钱包转出

将特定玩家的现金钱包的余额转出。

注解：

• transaction_ticket是每笔交易的唯一识别码。运营商需要为每笔传送请求发送新的识别码

• 对于重复请求，G7S不对玩家钱包余额进行任何操作，但返回转账成功的响应。

请求参数

API URL: {G7SSoftAPIDomain}/v1/Transfer/TransferOut

HTTP 方法 : POST

主体参数

例子：

参数：

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":0,

"message":"success",

"data":

{

"transaction_id":"T20250111112505Utest123",

"balance_before":94.19,

"balance_after":0,

"amount":94.19

}

}

5.7钱包转出所有余额

将特定玩家的现金钱包的所有余额转出。

注解：

• transaction_ticket是每笔交易的唯一识别码。运营商需要为每笔传送请求发送新的识别码

• 对于重复请求，G7S不对玩家钱包余额进行任何操作，但返回转账成功的响应。

请求参数

API URL: {G7SSoftAPIDomain}/v1/Transfer/TransferAllOut

HTTP 方法 : POST

主体参数

例子：

参数：

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":0,

"message":"success",

"data":

{

"transaction_id":"T20250111111329Utest123",

"balance_before":99.99,

"balance_after":0,

"amount":99.99

}

}

5.8钱包余额

获取特定玩家的现金钱包的余额。

请求参数

API URL: {G7SSoftAPIDomain}/v1/Transfer/BalanceQuery

HTTP 方法 : POST

主体参数

例子：

参数：

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":0,

"message":"success",

"data":

{

"balance":99.99

}

}

5.9投注历史记录

获取特定玩家投注历史记录：

请求参数API URL: {G7SSoftAPIDomain}/v1/History/GetHistory

HTTP 方法 : POST

主体参数

例子：

参数：

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":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} ]

}

5.10投注汇总

获取特定玩家投注汇总：

请求参数API URL: {G7SSoftAPIDomain}/v1/History/GetHistorySummary

HTTP 方法 : POST

主体参数

例子：

参数：

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":0,

"message":"success",

"data":{"bet_amount":6,"win_amount":-5.8,"game_id":0}

}

5.11钱包转入转出记录

获取特定玩家钱包的转入转出记录：

请求参数API URL: {G7SSoftAPIDomain}/v1/Transfer/TransferHistory

HTTP 方法 : POST

主体参数

例子：

参数：

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":0,

"message":"success",

"recordCount":2,

"data":[

{"Score":99.99,"OperationType":1,"InsertTimestamp":1736565516},

{"Score":99.99,"OperationType":2,"InsertTimestamp":1736565209}

]

}

5.12单一钱包游戏输赢回调接口

玩家每玩一局游戏都会调用运营商接口传递游戏输赢信息,需运营商提供接口存档数据：

HTTP 方法 : POST

主体参数

例子：

参数：

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,否则返回其它)

5.13游戏记录

充值现金至特定玩家的现金钱包。

注解：

• transaction_ticket是每笔交易的唯一识别码。运营商需要为每笔传送请求发送新的识别码

• 对于重复请求，G7S不对玩家钱包余额进行任何操作，但返回转账成功的响应。

请求参数

API URL: {G7SSoftAPIDomain}/api/bet_record

HTTP 方法 : POST

主体参数

例子：

参数：

{

    "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": [

{

                "ID": 2,

                "UserID": 11168，

  "KindID": 3002，

  "Flow": 68，

"WinLose": 68

            }

],

        "games": [

            {

                "KindID": 3002,

                "ClientID": 68

            },

            {

                "KindID": 9251,

                "ClientID": 1332

            }

        ]

    },

    "result": []

}

错误处理

操作提示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"

}

7. 安全建议

• 数据加密：建议运营商使用HTTPS加密数据传输，确保数据安全。

• 防重放攻击：建议使用时间戳或唯一标识符，防止重放攻击。

8.限制

8.1，IP限制

中国大陆地区的玩家将无法访问G7S游戏

8.2，货币限制

以下为不被 G7S 所支持的货币：

• HKD

• MOP

• MYR

• SGD

• TWD

• VES

• MBTC，UBTC，USDT，TUSD & USDC 除外的所有加密货

9. 附录

9.1，错误代码

9.2，货币代码

9.3，平台

9.4，语言