手游平台搭建技术对接文档

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\/thirdg