G7S API 对接文档

CS1

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.0.0 2024-10-08 修订文件初版
1.0.1 2024-12-30 卡尔更新代码细节
1.0.2 2026-06-28 新增单一钱包接口

1. 文档概述

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

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

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

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

2. 系统要求

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 浏览器

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

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接口

创建玩家

在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

    }

}

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

}

5.5游戏记录

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

注解:

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

}

5.6钱包转出

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

注解:

• 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

}

}

5.7钱包转出所有余额

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

注解:

• 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

}

}

5.8钱包余额

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

请求参数

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

}

}

5.9投注历史记录

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

请求参数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} ]

}

5.10投注汇总

获取特定玩家投注汇总:

请求参数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}

}

5.11钱包转入转出记录

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

请求参数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}

]

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

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

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"

}

7. 安全建议

8.限制

8.1,IP限制

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

8.2,货币限制

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

• HKD

• MOP

• MYR

• SGD

• TWD

• VES

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

9. 附录

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 西班牙语