1. 文档描述

本文档主要用于对接平台第三方游戏，我方平台通过接口请求贵方，贵方返回可接入的游戏和参数。玩家通过我方平台下载游戏，玩家在游戏内进行注册和充值操作的时候，贵方通过接口将数据传入我方平台，我方平台进行数据同步，不清楚可以搜索溪谷软件官网查看，免费下载哟。

1. 贵方平台提供资料

接口或数据	示例	说明
秘钥	28zG9cSKGpSCuZ3GqeFFj1bW	接口加密秘钥，贵方提供，两方秘钥须一致。如有改动，请尽快通知我方更新。
平台标识	qijiansdk	我方在贵平台的唯一标识，双方接口请求必传。
平台域名	http://local.qijian.cn	贵方平台域名
获取可导入游戏数量接口	webplatform/game_api/selectGames	返回我方剩余可导入游戏数量
游戏导入接口	webplatform/game_api/importGames	返回所有可导入游戏的详细数据
区服导入接口	webplatform/game_api/importServer	返回单款游戏所有可导入的区服信息
礼包导入接口	webplatform/game_api/importGift	返回单款游戏所有可导入的礼包信息
游戏原包接口	webplatform/game_api/importSource	返回单款游戏游戏原包下载地址
导入订单接口	webplatform/game_api/importorders	返回对应的订单信息
更新支付回调接口	webplatform/game_api/updatePayStatus	返回该订单的支付回调状态

1. 获取可导入游戏接口

我方请求贵方可导入游戏接口，贵方返回我方平台剩余可导入游戏数量。

我方请求参数  (数组格式) (POST)

参数	参数名称	类型	必填	说明
timestamp	时间戳	Int	是	当前时间戳
platform	平台标识	String	是	我方平台在贵方的标识
sign	加密验签值	String	是	加密验签值，贵方请进行验签
game_ids	已导入游戏	Array	是	我方已导入的贵方游戏ID，一维数组，贵方请排除这些游戏

例：

{
    "timestamp":1629775120,
    "platform":"qijiansdk",
    "sign":"af89f9a29dd8d0af01a4815d5e451ec8",

"game_ids":[ 1,2,3,4]
}

贵方返回参数（JSON格式）

参数	参数名称	类型	必填	说明
status	状态码	Int	是	成功：200  其他：失败
msg	返回信息	String	是	成功
data	返回值	Array	是	返回值
count	可导入游戏数量	Int	是	我方可导入游戏数量

例：

{"status":200,"msg":"\u8bf7\u6c42\u6210\u529f","data":{"count":32}}

1. 导入游戏接口

  我方请求贵方导入游戏接口，贵方返回具体游戏数据。

我方请求参数  (数组格式) (POST)

参数	参数名称	类型	必填	说明
timestamp	时间戳	Int	是	当前时间戳
platform	平台标识	String	是	我方平台在贵方的标识
sign	加密验签值	String	是	加密验签值，贵方请进行验签
game_ids	已导入游戏	Array	是	我方已导入的贵方游戏ID，一维数组，贵方请排除这些游戏

例：

{
    "timestamp":1629775120,
    "platform":"qijiansdk",
    "sign":"af89f9a29dd8d0af01a4815d5e451ec8",

"game_ids":[ 1,2,3,4]
}

贵方返回参数（JSON格式）

参数	参数名称	类型	必填	说明
status	状态码	Int	是	成功：200  其他：失败
msg	返回信息	String	是	成功
data	返回值	Array	是	返回值
game_id	贵方游戏ID	Int	是	贵方游戏ID
game_name	游戏名称	varchar	是	游戏名称，手游后面需要拼接（安卓版）/（苹果版）
sort	游戏排序	Int	否	游戏排序
short	游戏简写	Varchar	是	游戏大写字母简写
game_score	游戏评分	Int	否	游戏评分，最高10
tag_name	游戏标签	varchar	否	游戏标签，最多支持三个，逗号拼接
features	游戏简介	Varchar	否	游戏一句话简介
introduction	详细介绍	Varchar	否	详细介绍
recommend_status	推荐指数	Int	否	推荐状态(0:不推荐,1推荐 2热门 3最新)
icon	游戏图标	Varchar	否	游戏图标完整地址， 建议尺寸200*200
cover	游戏封面	Varchar	否	游戏封面完整地址，尺寸278x372px
material_url	游戏素材	Varchar	否	游戏素材完整下载地址
hot_cover	热门封面图		否	游戏热门封面，尺寸386x272px
screenshot	游戏截图	Varchar	否	游戏截图完整地址，最多三张，用逗号拼接，
groom	游戏详情页推荐图	Varchar	否	游戏详情页推荐图,1920px*270px
dow_num	下载量	int	否	游戏下载量
sdk_version	游戏版本	Int	是	游戏版本 1安卓 2苹果 3H5 4页游
game_size	游戏大小	Varchar	否	手游包大小
relation_game_name	游戏关联名称	Varchar	否	游戏名称 不包含（安卓版）/（苹果版
ratio	分成比例	Int	是	CPS分成比例
add_game_address	安卓包下载地址	Varchar	否	安卓包下载地址，安卓手游不能为空
ios_game_address	苹果包下载地址	Varchar	否	苹果包下载地址，苹果手游不能为空
third_party_url	H5和页游地址	Varchar	否	H5和页游地址，H5和页游不能为空
down_port	下载端口	int	是	1.官方下载  3苹果超级签下载
pay_download	超级签付费下载	int	是	1：开启  0：关闭
pay_price	超级签付费金额	int	是	超级签付费下载支付金额，没有则传0
promote_id	我方所属渠道ID	int	是	我方再贵平台渠道ID ,溪谷打包使用
promote_account	我方所属渠道账号	varchar	是	我方再贵平台渠道账号 ,溪谷打包使用

例：

{"status":200,"msg":"\u6210\u529f","data":[{"game_id":36,"game_name":"\u4f1f\u5927\u4f1f\u5927\u65f6\u4ee3\u662f\u7684","sort":50,"short":"WDWDSDSD","game_score":8,"tag_name":"\u9996\u53d1,\u4e0a\u7ebf\u9001v15,Q\u7248\u4eba\u7269","features":"\u4e00\u6b3e\u70ed\u8840\u4f20\u5947\u9898\u6750\u7684ARPG\u6e38\u620f\uff0c\u4f20\u5947\u7ecf\u5178\u7248\u672c\uff0c\u5343\u4eba\u540c\u5c4f\uff0c\u4e07\u4eba\u540c\u6218\u3002","introduction":"\u4e00\u6b3e\u70ed\u8840\u4f20\u5947\u9898\u6750\u7684ARPG\u6e38\u620f\uff0c\u4f20\u5947\u7ecf\u5178\u7248\u672c\uff0c\u5343\u4eba\u540c\u5c4f\uff0c\u4e07\u4eba\u540c\u6218\u3002\u4e00\u6b3e\u70ed\u8840\u4f20\u5947\u9898\u6750\u7684ARPG\u6e38\u620f\uff0c\u4f20\u5947\u7ecf\u5178\u7248\u672c\uff0c\u5343\u4eba\u540c\u5c4f\uff0c\u4e07\u4eba\u540c\u6218\u3002","recommend_status":"1","icon":"http:\/\/local.jianhua.cn\/upload\/game\/20210823\/7b094e76911ae6cfca384f704009d6df.jpg","cover":"http:\/\/local.jianhua.cn\/upload\/thirdgame\/20210818\/53eef78fc600b0646847f6947bd416d3.jpg","material_url":"http:\/\/local.jianhua.cn\/upload\/game\/20210823\/22b64e4a111fcc497f848caf461f72c3.zip","hot_cover":"http:\/\/local.jianhua.cn\/upload\/game\/20210821\/f51abab4958227526aa5f2e8392bc9ea.jpg","screenshot":"http:\/\/local.jianhua.cn\/upload\/thirdgame\/20210818\/a46fb3a923d2112570a327f4a4e03002.jpg,http:\/\/local.jianhua.cn\/upload\/game\/20210821\/e8ac9762cf5d78f5b1c2803ee60013ad.jpg,http:\/\/local.jianhua.cn\/upload\/game\/20210821\/589d243e2173c60e4df628a58a2a62a8.jpg","groom":"http:\/\/local.jianhua.cn\/upload\/game\/20210823\/b11bf0faf72fa7c6f92afdfbf154f9b9.jpg","dow_num":5222,"sdk_version":3,"game_size":"0MB","relation_game_name":"\u4f1f\u5927\u4f1f\u5927\u65f6\u4ee3\u662f\u7684","ratio":0,"pack_url":"","promote_id":11,"third_party_url":"http:\/\/local.jianhua.cn\/mobile\/game\/open_game\/game_id\/36\/pid\/11"}]}

1. 导入游戏区服接口

  我方请求贵方导入游戏区服接口，贵方返回具体游戏区服数据。

我方请求参数  (数组格式) (POST)

参数	参数名称	类型	必填	说明
timestamp	时间戳	Int	是	当前时间戳
platform	平台标识	String	是	我方平台在贵方的标识
sign	加密验签值	String	是	加密验签值，贵方请进行验签
game_id	游戏ID	Int	是	游戏ID
server_ids	已导入区服ID	Array	是	我方已导入的贵方区服ID，一维数组，贵方请排除这些区服

例：

{
    "timestamp":1629775120,
    "platform":"qijiansdk",
    "sign":"af89f9a29dd8d0af01a4815d5e451ec8",
    "game_id":"26",
    "server_ids":[ 1,2,3,4]
}

贵方返回参数（JSON格式）

参数	参数名称	类型	必填	说明
status	状态码	Int	是	成功：200  其他：失败
msg	返回信息	String	是	成功
data	返回值	Array	是	返回值
id	区服ID	Int	是	贵方区服ID
server_name	区服名称	varchar	是	贵方区服名称
server_num	真实区服ID	Int	否	CP真实区服ID
start_time	开始时间	varchar	是	区服开始时间
desride	描述	varchar	否	区服描述

例：

{"status":200,"msg":"\u6210\u529f","data":[{"id":4,"server_name":"\u53cc\u7ebf1\u533a","server_num":"123","start_time":1629861900,"desride":"\u53cc\u7ebf1\u533a\u53cc\u7ebf1\u533a\u53cc\u7ebf1\u533a"}]}

1. 导入游戏礼包接口

  我方请求贵方导入游戏礼包接口，贵方返回具体游戏礼包数据。游戏礼包为我方平台专享，其他平台不支持领取。

我方请求参数  (数组格式) (POST)

参数	参数名称	类型	必填	说明
timestamp	时间戳	Int	是	当前时间戳
platform	平台标识	String	是	我方平台在贵方的标识
sign	加密验签值	String	是	加密验签值，贵方请进行验签
game_id	游戏ID	Int	是	游戏ID
gift_ids	已导入礼包ID	Array	是	我方已导入的贵方礼包ID，一维数组，贵方请排除这些礼包

例：

{
    "timestamp":1629775120,
    "platform":"qijiansdk",
    "sign":"af89f9a29dd8d0af01a4815d5e451ec8",
    "game_id":"26",
    "gift_ids":[ 1,2,3,4]
}

贵方返回参数（JSON格式）

参数	参数名称	类型	必填	说明
status	状态码	Int	是	成功：200  其他：失败
msg	返回信息	String	是	成功
data	返回值	Array	是	返回值
id	礼包ID	Int	是	贵方游戏礼包ID
giftbag_name	礼包名称	varchar	是	贵方游戏礼包名称
novice	礼包码	Varchar	是	礼包码，逗号拼接
digest	礼包内容	varchar	是	礼包包含内容
desribe	使用说明	varchar	否	礼包使用说明
competence	兑换资格	varchar	否	兑换资格
notice	注意事项	varchar	否	注意事项
start_time	开始时间	int	是	礼包开始时间戳
end_time	结束时间	int	是	礼包结束时间戳
novice_num	礼包码数量	int	是	礼包码数量
type	礼包类型	int	是	1普通码  2 统一码

例：

{"status":200,"msg":"\u6210\u529f","data":[{"id":7,"giftbag_name":"\u6d4b\u8bd5\u793c\u5305","novice":"sdsdsdsd,2ewdwdsd,fdfdfdfdfdsf,rffffffff","digest":"\u91d1\u5e01x2000000,\u5341\u8fde\u62db\u52df\u5238x2,\u5143\u5b9dx1000,\u9ad8\u7ea7\u7ecf\u9a8c\u4e66x200","desribe":"","competence":"","notice":"","start_time":1629776360,"end_time":0,"novice_num":4,"remain_num":4,"sort":0,"type":1}]}

1. 更新游戏原包接口

  我方请求贵方更新游戏原包接口，贵方返回具体游戏原包下载地址数据。

我方请求参数  (数组格式) (POST)

参数	参数名称	类型	必填	说明
timestamp	时间戳	Int	是	当前时间戳
platform	平台标识	String	是	我方平台在贵方的标识
sign	加密验签值	String	是	加密验签值，贵方请进行验签
game_id	游戏ID	Int	是	贵方游戏ID

例：

{
    "timestamp":1629776605,
    "platform":"qijiansdk",
    "sign":"0a2a208fb4910172aee7624baba01b10",
    "game_id":"27"
}

贵方返回参数（JSON格式）

参数	参数名称		类型	必填	说明
status	状态码		Int	是	成功：200  其他：失败
msg	返回信息		String	是	成功
data	返回值		Array	是	返回值
game_id	游戏id		int	是	贵方游戏ID
game_name	游戏名		Varchar	是	贵方游戏名
game_appid	游戏appid		varchar	是	贵方游戏appid,溪谷渠道打包用
promote_id	渠道id		int	是	贵方渠道ID，溪谷渠道打包用
promote_account	渠道账号		Varchar	是	贵方渠道账号，溪谷渠道打包用
bao_name	游戏真实包名		Varchar	否	游戏真实包名, 苹果必传
file_size	游戏包大小		varchar	否	游戏包大小
source_version	游戏版本号		Int	是	游戏版本号
source_name	游戏版本名		varchar	否	游戏版本名
remark	描述		varchar	否	描述
file_url	文件下载地址		Varchar	是	游戏原包直接下载地址
down_port	下载端口		int	是	1：官方原包 3：超级签下载
pay_download		超级签付费下载	int	是	1：开启  0：关闭
pay_price		超级签付费金额	int	是	超级签付费下载支付金额，没有则传0

例：

{"status":200,"msg":"\u6210\u529f","data":{"bao_name":"com.bingxue.jinfeng","file_size":"92.16MB","source_version":211,"source_name":"2.1.1","remark":"","file_url":"http:\/\/local.jianhua.cn\/upload\/android\/game_package27-11.apk"}}

1. 用户登录接口

  我方平台玩家在贵方SDK内登录，贵方请求用户登录接口查询该用户是否存在，接口返回成功则允许登录。如果该用户在我方平台存在，但是在贵方平台不存在，请贵方自动注册一个用户并与本平台用户绑定。

接口地址：我方平台域名/thirdgame/api/user_login

贵方请求参数  (数组格式) (POST)

参数	参数名称	类型	必填	说明
timestamp	时间戳	Int	是	当前时间戳
platform	平台标识	String	是	贵方提供得平台域名
sign	加密验签值	String	是	加密验签值，请参照加密方式进行加密
account	用户账号	varchar	是	玩家登录账号
password	用户密码	varchar	是	玩家密码，请参照文档最后玩家密码加密方式加密后传值
promote_id	渠道ID	Int	是	我方渠道ID,请参照文档获取渠道信息进行传值，默认传0
game_id	游戏ID	Int	是	贵方游戏ID
login_ip	登录ip	varchar	是	玩家登录IP

例：

{
    "timestamp":1629776605,
    "platform":"qijiansdk",
    "sign":"0a2a208fb4910172aee7624baba01b10",
    "game_id":27,

"account":"asdasd",

"password":"sssssssssssssssssss",

"promote_id":0,

“login_ip”:”127.0.0.1”,

}

我方返回参数（JSON格式）

参数	参数名称	类型	必填	说明
status	状态码	Int	是	成功：200  其他：失败
msg	返回信息	String	是	成功
data	返回值	Array	是	返回值
user_id	用户ID	Int	是	我方用户ID，请与贵方用户绑定，唯一标识
account	账号	varchar	是	我方玩家账号
idcard	玩家身份证号	Int	否	玩家身份证号
real_name	玩家真实姓名	varchar	否	玩家真实姓名
age_status	实名认证状态	varchar	否	实名认证状态 0：未认证 2：已成年 3：未成年4：认证中
phone	玩家手机号	Varchar	否	玩家手机号
email	玩家邮箱	Varchar	否	玩家邮箱

例：

{"status":200,"msg":"\u6210\u529f","data":{"user_id":21,"account":"asdasd","idcard":"320381xxx","real_name":"\u6210\u529f","age_status":2,"phone":"1875176xxxx","email":"123@qq.com"}}

1. 用户注册接口

  玩家在贵方游戏SDK内进行注册操作，贵方请求我方用户注册接口，传入玩家注册信息，我方平台返回注册成功之后，贵方保存相关用户标识。

接口地址：我方平台域名/thirdgame/api/user_register

贵方请求参数  (数组格式) (POST)

参数	参数名称	类型	必填	说明
timestamp	时间戳	Int	是	当前时间戳
platform	平台标识	String	是	贵方提供得平台域名
sign	加密验签值	String	是	加密验签值，请参照加密方式进行加密
account	用户账号	varchar	是	玩家登录账号
password	用户密码	varchar	是	玩家密码，请参照文档最后玩家密码加密方式加密后传值
promote_id	渠道ID	Int	是	我方渠道ID,请参照文档获取渠道信息进行传值，默认传0
game_id	游戏ID	Int	是	贵方游戏ID
register_ip	注册ip	varchar	是	玩家注册IP
nikcname	玩家昵称		否	玩家注册昵称
phone	手机号		否	玩家手机号
email	邮箱		否	玩家邮箱
register_way	注册来源		否	注册来源：1sdk;2app;3pc;4wap
register_type	注册方式		否	注册方式：0游客;1账号;2手机;3微信;4qq;
real_name	真实姓名		否	玩家真实姓名
idcard	身份证		否	玩家身份证
age_status	认证状态		否	实名认证状态 0：未认证 2：已成年 3：未成年4：认证中

例：

{
    "timestamp":1629776605,
    "platform":"qijiansdk",
    "sign":"0a2a208fb4910172aee7624baba01b10",
    "game_id":27,

"account":"asdasd",

"password":"sssssssssssssssssss",

"promote_id":0,

“register_ip”:”127.0.0.1”,

“nikcname”:”asdasd”,

“phone”:”1875176xxx”,

“email”:”123@qq.com”,

“register_way”:1,

“register_type”:1,

“real_name”:”张三”,

“idcard”:”320381xxx”,

“age_status”:2,

}

我方返回参数（JSON格式）

参数	参数名称	类型	必填	说明
status	状态码	Int	是	成功：200  其他：失败
msg	返回信息	String	是	成功
data	返回值	Array	是	返回值
user_id	用户ID	Int	是	我方用户ID，请与贵方用户绑定，唯一标识
account	账号	varchar	是	我方玩家账号

例：

{"status":200,"msg":"\u6210\u529f","data":{"user_id":21,"account":"asdasd"}}

1. 获取用户信息接口

  贵方通过此接口获取玩家信息，例如手机号，实名认证状态。

接口地址：我方平台域名/thirdgame/api/get_user_info

贵方请求参数  (数组格式) (POST)

参数	参数名称	类型	必填	说明
timestamp	时间戳	Int	是	当前时间戳
platform	平台标识	String	是	贵方提供得平台域名
sign	加密验签值	String	是	加密验签值，请参照加密方式进行加密
user_id	用户id	varchar	否	玩家ID，我方平台玩家唯一标识
account	用户账号	Varchar	否	玩家账号 验证玩家账号是否存在
phone	玩家手机号	Varchar	否	玩家绑定手机号，发送短信验证玩家是否存在，其他情况不传
email	玩家邮箱	Varchar	否	玩家绑定邮箱，发送邮箱验证玩家是否存在，其他情况不传
type	验证方式	Int	是	验证方式  1：用户ID  2：手机号 3：邮箱 4：账号

例：

{
    "timestamp":1629776605,
    "platform":"qijiansdk",
    "sign":"0a2a208fb4910172aee7624baba01b10",
    "user_id":27,

}

我方返回参数（JSON格式）

参数	参数名称	类型	必填	说明
status	状态码	Int	是	成功：200  其他：失败
msg	返回信息	String	是	成功
data	返回值	Array	是	返回值
user_id	用户ID	int	是	我方玩家ID
account	玩家账号	varchar	是	我方玩家账号
real_name	真实姓名	varchar	是	玩家真实姓名
idcard	身份证	varchar	是	玩家身份证
age_status	认证状态	int	是	实名认证状态 0：未认证 2：已成年 3：未成年4：认证中
phone	手机号	varchar	是	玩家手机号
email	邮箱	varchar	是	玩家邮箱

例：

{"status":200,"msg":"\u6210\u529f","data":{"idcard":"320381xxx","real_name":"\u6210\u529f","age_status":2,"phone":"1875176xxxx","email":"123@qq.com"}}

1. 修改用户信息接口

  玩家在贵方游戏SDK内进行修改信息后 ，贵方请求我方用户信息修改接口，传入玩家修改信息，我方平台同步修改。

接口地址：我方平台域名/thirdgame/api/set_user_info

贵方请求参数  (数组格式) (POST)

参数	参数名称	类型	必填	说明
timestamp	时间戳	Int	是	当前时间戳
platform	平台标识	String	是	贵方提供得平台域名
sign	加密验签值	String	是	加密验签值，请参照加密方式进行加密
user_id	用户ID	varchar	是	用户ID，我方平台玩家唯一标识
password	用户密码	varchar	否	玩家密码，请参照文档最后玩家密码加密方式加密后传值
phone	手机号		否	玩家手机号
email	邮箱		否	玩家邮箱
real_name	真实姓名		否	玩家真实姓名
idcard	身份证		否	玩家身份证
nickname	昵称		否	玩家昵称
age_status	认证状态		否	实名认证状态 0：未认证 2：已成年 3：未成年4：认证中

例：

{
    "timestamp":1629776605,
    "platform":"qijiansdk",
    "sign":"0a2a208fb4910172aee7624baba01b10",
    "user_id":27,

“password”:’asdsadsdsdddddd’,

“phone”:”1875176xxx”,

“email”:”123@qq.com”,

“real_name”:”张三”,

“idcard”:”320381xxx”,

“age_status”:2,

}

我方返回参数（JSON格式）

参数	参数名称	类型	必填	说明
status	状态码	Int	是	成功：200  其他：失败
msg	返回信息	String	是	成功

例：

{"status":200,"msg":"\u6210\u529f"}

1. 获取订单折扣

  玩家在贵方平台游戏内点击支付，贵方请求该接口，我方返回对应的订单折扣。

接口地址：我方平台域名/thirdgame/api/pay_init

贵方请求参数  (数组格式) (POST)

参数	参数名称	类型	必填	说明
timestamp	时间戳	Int	是	当前时间戳
platform	平台标识	String	是	贵方提供得平台域名
sign	加密验签值	String	是	加密验签值，请参照加密方式进行加密
user_id	用户id	Int	是	我方玩家ID，平台玩家唯一标识
game_id	游戏ID	int	是	贵方游戏ID

例：

{
    "timestamp":1629776605,
    "platform":"qijiansdk",
    "sign":"0a2a208fb4910172aee7624baba01b10",
    "user_id":27,

“game_id”:22

}

我方返回参数（JSON格式）

参数	参数名称	类型	必填	说明
status	状态码	Int	是	成功：200  其他：失败
msg	返回信息	String	是	成功
data	返回值	Array	是	返回值
discount	折扣	Int	是	订单折扣
discount_type	折扣类型	int	是	0:无折扣 1：首冲 2：续充

例：

{"status":200,"msg":"\u6210\u529f","data":{"discount":5}}

1. 导入订单接口

  我方平台每隔一段时间主动请求贵方导入订单接口，传入最后支付时间和查询订单个数，贵方平台根据最后支付时间，返回该时间之后的支付成功的订单数据。

我方请求参数  (数组格式) (POST)

参数	参数名称	类型	必填	说明
timestamp	时间戳	Int	是	当前时间戳
platform	平台标识	String	是	我方平台在贵方的标识
sign	加密验签值	String	是	加密验签值，贵方请进行验签
last_pay_time	最后支付时间	Int	是	我方最后一条订单的支付时间，贵方返回该时间之后对应订单
limit	返回个数	int	是	返回对应订单个数，默认10条

贵方返回值  (JSON格式)

参数	参数名称	类型	必填	说明
user_id	用户id	Int	是	我方用户id
game_id	游戏ID	Int	是	贵方游戏ID
spend_ip	支付ip	varchar	是	玩家支付IP
pay_way	支付方式	Int	是	1绑币，2:平台币,3:支付宝,4:微信
pay_amount	实际支付金额	Int	是	实际付款金额，单位元
cost	订单原价	Int	是	订单折扣前原价
pay_type	支付通道	Int	是	1：贵方平台  2:我方平台
trade_no	贵方订单号	Varchar	是	贵方订单号
order_number	第三方订单号	varchar	否	支付宝/微信商户订单号
pay_time	支付时间	int	是	订单支付时间戳
pay_status	支付状态	int	是	订单支付状态 1.成功  0失败
pay_game_status	游戏通知状态	int	是	游戏通知状态  1.成功 0失败
discount_type	折扣方式	Int0	是	0：无折扣； 1首冲折扣； 2续充折扣
discount	折扣	Int	否	订单折扣
server_id	区服ID		否	区服ID
server_name	区服名	Varchar	否	区服名
game_player_id	角色ID	Varchar	否	角色ID
game_player_name	角色名	Varchar	否	角色名
role_level	角色等级	Varchar	否	角色等级
props_name	订单道具名	Varchar	否	订单道具名

1. 支付通知补单接口

我方请求贵方支付通知补单接口，贵方返回订单游戏通知状态。

我方请求参数  (数组格式) (POST)

参数	参数名称	类型	必填	说明
timestamp	时间戳	Int	是	当前时间戳
platform	平台标识	String	是	我方平台在贵方的标识
sign	加密验签值	String	是	加密验签值，贵方请进行验签
trade_no	订单号	varchar	是	贵方订单号

例：

{
    "timestamp":1629775120,
    "platform":"qijiansdk",
    "sign":"af89f9a29dd8d0af01a4815d5e451ec8",

"trade_no":‘qweqweqwe’
}

贵方返回参数（JSON格式）

参数	参数名称	类型	必填	说明
status	状态码	Int	是	成功：200  其他：失败
msg	返回信息	String	是	成功
data	返回值	Array	是	返回值
pay_game_status	通知状态	Int	是	游戏通知状态 1成功 0失败

例：

{"status":200,"msg":"\u8bf7\u6c42\u6210\u529f","data":{"count":32}}

1. 角色上传接口  

贵方再上传角色的同时请我方平台上传角色接口，我放存入玩家角色数据。

接口地址：我方平台域名/thirdgame/api/save_user_play

贵方请求参数  (数组格式) (POST)

参数	参数名称	类型	必填	说明
timestamp	时间戳	Int	是	当前时间戳
platform	平台标识	String	是	贵方提供得平台域名
sign	加密验签值	String	是	加密验签值，请参照加密方式进行加密
user_id	用户ID	varchar	是	用户ID，我方平台玩家唯一标识
game_id	用户id	varchar	是	贵方平台游戏ID
play_ip	玩家ip	varchar	是	玩家ip
server_id	区服ID	Varchar	否	区服ID
server_name	区服名	Varchar	否	区服名
role_id	角色ID	Varchar	否	角色ID
role_name	角色名	Varchar	否	角色名
role_level	角色等级	Varchar	否	角色等级
combat_number	战力值	Varchar	否	战力值
player_reserve	额外信息	varchar	否	额外信息

例：

{
    "timestamp":1629776605,
    "platform":"qijiansdk",
    "sign":"0a2a208fb4910172aee7624baba01b10",
    "user_id":27,

“game_id”:25

“play_ip”:’127.0.0.1’,

“server_id”:”1”,

“server_name”:”一区”,

“role_id”:”255525”,

“role_name”:”张三”,

“role_level”:”125”,

“combat_number”:’525884’

}

我方返回参数（JSON格式）

参数	参数名称	类型	必填	说明
status	状态码	Int	是	成功：200  其他：失败
msg	返回信息	String	是	成功

例：

{"status":200,"msg":"\u6210\u529f"}

1. H5或页游进入游戏

我方在贵方游戏地址后面拼接上用户信息user_token,贵方拿到该token后进行解密，解密方法如下，拿到有用户的user_id等信息，然后进入游戏。

token内所含信息

user_id	用户ID	varchar	用户ID，我方平台玩家唯一标识
account	账号	varchar	用户账号
phone	手机号	varchar	玩家手机号
email	邮箱	varchar	玩家邮箱
real_name	真实姓名	varchar	玩家真实姓名
idcard	身份证	varchar	玩家身份证
age_status	认证状态	int	实名认证状态 0：未认证 2：已成年 3：未成年4：认证中

1. 我方渠道ID获取

我方在贵方原包基础上可能会进行渠道打包，在原包包体内写入渠道信息。在贵方原包已有渠道信息基础上拼接上我方渠道ID，请贵方获取该渠道ID后在用户相关接口传来。

拼接规则：贵方渠道Id_XgPid_我方渠道ID

手游平台搭建技术对接文档相关推荐

1. 详解手游平台搭建需要哪些条件？需要注意什么？

   手游平台的搭建,虽然简单,但仍有许多条件要求和注意事项.本文将结合实际,详细解读手游平台搭建过程中必要条件以及相关注意事项. 一.游戏平台搭建必须条件 首先是营业执照.营业执照即企业或组织合法经营的凭 ...

2. 手游平台搭建流程是怎样的？

   随着游戏行业的发展,手游代理出现在大众面前,手游平台搭建也不需要像以前那样学习编程知识.建立技术团队等这样繁琐的步骤,导致需要花费很多人力.物力.财力.现在的市场上有很多成熟且正规的游戏平台研发商,可 ...

3. 韵达快递上门取件API技术对接文档 java

   韵达快递上门取件,是电商平台为寄件用户提供的通过一键下单到快递员,并在2小时上门取件的寄件服务.适用于散客在线寄件.电商退货上门取件等业务场景:通过API指令由系统自动将消息发送给物流公司和快递员,由 ...

4. 手游平台源码搭建有什么好处？

   手游平台搭建市面上有很多种选择,价格几千元到几万元不等,为什么大多数人都选择源码搭建呢?源码是指编写的最原始程序的代码.程序员编写程序的过程中需要他们的"语言",其的工作的语言就是 ...

5. 如何快速搭建手游平台?

   手机APP的功能是很复杂的,比如手机注册登录.第三方注册登录.验证码登录等等,还有密码找回.密码修改功能,还有邮件通道.短信通道.充Z借口等等.在这个方面,要做好长期的规划,不然以后统计数据的收集和建 ...

6. 手游平台开发怎么做？

   根据相关的数据,目前手游市场的发展速度有所减缓,但依然有很大的发展空间.随着5 G时代的来临,再加上大家手里都有了手机,玩家数量也在不断增加,手游市场的发展前景也会越来越好,可以预见,这将会是一个稳步 ...

7. java计算机毕业设计会展中心招商服务平台MyBatis+系统+LW文档+源码+调试部署

   java计算机毕业设计会展中心招商服务平台MyBatis+系统+LW文档+源码+调试部署 java计算机毕业设计会展中心招商服务平台MyBatis+系统+LW文档+源码+调试部署 本源码技术栈: 项目 ...

8. 游戏运营创业——个人如何选择手游平台？

   现在的人都是和手机密不可分的,玩手机已经成为了一种娱乐方式.再加上现在的手机游戏市场和未来,这是一个人人都能参与的新产业,也是一个巨大的商机. 今天小编要说的就是一个人做游戏代理运营的创业,该怎么选择 ...

9. 易验APP一键登录对接文档

   易验APP一键登录对接文档 1. 能力申请 注意事项: 1.认证取号服务必须打开蜂窝数据流量,并且应用应有蜂窝数据权限: 2.取号请求过程需要消耗用户少量数据流量(国外漫游时可能会产生额外的费用): ...

最新文章

1. mysql用binlog恢复数据_mysql 利用 binlog 恢复数据
2. 【7】青龙面板系列教程之任务消息定时推送
3. 做了表分区以后的数据库表，在使用程序进行修改操作时报异常。
4. springcloud——eureka小错误Caused by: java.net.UnknownHostException: eureka7003.com
5. 关于 OutOfMemoryError 的总结与解决方法
6. DIV+CSS常见错误汇总
7. python 导入其他目录下的模块
8. idea 设置默认 jdk
9. 卓克-为什么没有动物比蓝鲸的体型大？
10. 二维码生成（如何实现扫描二维码，实现网址自动跳转？）：扫码直接进入网页，直接进入网址页面
11. android开发 多语言和国际化（转）
12. 配置cfree 5 支持C++11
13. 机械革命笔记本开关键盘亮度
14. 高德地图定位 地图比例缩放
15. window关闭烦人的右下角广告
16. linux tomcat cpu占用高,排查tomcat服务器CPU使用率过高
17. 即插即用demo系列——文本相似度比较
18. 深度学习中AP、mAP、recall、IoU、NMS的评价指标介绍
19. 笔录 Flutter（二）Image的属性、使用、圆角、圆形
20. DataFrame按照时间分组然后求平均

热门文章

1. 创造与魔法怎么自建服务器,创造与魔法如何搭建出梦想中的房屋
2. 网页抖音批量取消关注JS代码
3. gentoo php,Gentoo 下安装 PHP 扩展
4. 《越狱》中的项目管理——两个版本的对比
5. springboot上传文件临时文件夹找不到不能成功上传问题
6. 使用Vuforia创建神奇宝贝GO风格增强现实游戏
7. python turtle库输出文字_Python 海龟 turtle 画图讲解 (五)：输入/输出文字及鼠标与键盘交互设计...
8. 行人轨迹论文阅读SSAGCN: Social Soft Attention Graph Convolution Network for Pedestrian Trajectory Prediction
9. java小游戏 飞翔的小鸟，校园新手入门，分分钟带你玩转编程
10. HCIA网工数通Datacom之网工初级