豪门足球对接文档

流程图

更新：

UC接收Facebook信息接口添加参数：fbsource，last_name，first_name ————-2018/8/21

数填写说明：

Y—->必须,N—非必须

商户密钥（key）:

商户密钥是通讯中用户数据加密及签名验证过程中所需的加密钥匙，该钥匙由双方接口技术人员约定。

接口前缀：

地址：https://tecnofut.xcloudgame.com/

调用登录及支付接口：

H5页面地址：https://tecnofut.xcloudgame.com/Pt/landing
下单接口（post）（https://域名/Pt/order）
谷歌支付验证接口（post）（https://域名/Googlepay/check）
苹果验证接口（post）（https://域名/Applepay/check）
订单状态查询接口（post）（https://tecnofut.xcloudgame.com/Pt/checkorder）
UC接收选服信息接口：https://tecnofut.xcloudgame.com/Pt/getsid
UC接收Facebook信息接口：https://tecnofut.xcloudgame.com/Pt/getfb
UC接收accountkit信息接口：https://tecnofut.xcloudgame.com/Pt/getaccountkit
UC接收google信息接口：https://tecnofut.xcloudgame.com/Pt/getgoogle
获取ios手机信息接口：https://tecnofut.xcloudgame.com/Pt/getios
ios生成游客接口：https://tecnofut.xcloudgame.com/Pt/tourist
ios游客绑定接口：https://tecnofut.xcloudgame.com/Pt/touristdb
获取安卓手机信息接口：https://tecnofut.xcloudgame.com/Pt/getandroid
写入角色信息：https://tecnofut.xcloudgame.com/Pt/userinfo
角色升级修改信息：https://tecnofut.xcloudgame.com/Pt/userup
埋点接口：https://tecnofut.xcloudgame.com/Pt/buried
接收source接口：https://tecnofut.xcloudgame.com/Pt/getsource
添加分享图片：https://tecnofut.xcloudgame.com/Pt/upload
找回密码接口（点击找回密码，跳转到浏览器，访问手机端网页版找回密码）

返回值类型：

json

登录注册

登录注册采用SDK调用H5登录注册页面方式展示登录注册页，在登录注册后给H5返回结果，H5根据结果与SDK交互

Status：200、100、101……108、109、（见返回值代码说明）
data：uid

成功后 返回json串其中status状态码，data 用户信息

SDK通知游戏客户端登录注册结果

修改后UC接收选服信息接口

https://tecnofut.xcloudgame.com/Pt/getsid

参数名 参数类型 最大长度 是否必填 描述
uid string 20 Y 用户UID
lastsid int 10 Y 游戏服务器编码
entry_type int 10 N 入口类型
entry_name string 50 N 入口名称
entry_lang string 50 N 语言
source string 50 Y 下载渠道
mainsource string 50 N 入口主渠道
subsource string 50 N 入口子渠道
gidloginid string 50 Y 接收Facebook信息返回的数据
url string 50 N 来源url
time int 11 Y 操作时间 unix 时间戳（以秒为单位)
sign String 50 Y 数字签名：双方需要验证此信息的正确性
签名方法

所有字段按照字典顺序排序后经过两次md5加密 sign=md5(md5(“key1=value1&key2=value2&$key”)) 加密key直接拼接在字符串后

Status：200、100、101……108、109、（见返回值代码说明）

成功后 返回json串其中status状态码

修改后UC接收Facebook信息接口

https://tecnofut.xcloudgame.com/Pt/getfb

参数名 参数类型 最大长度 是否必填 描述
token_for_business String 50 Y facebook用户的bid，唯一区分facebook用户
ids_for_business String 260 Y 用户授权过我们的所有游戏的Facebookapp信息 json数据 不参与加密
type String 50 Y 设备类型（1代表安卓、2代表ios）
device String 260 Y 设备信息（ios/android）json数据 不参与加密
gameid String 50 Y facebook用户第一次玩的游戏的gameid，我们定义的gameid
fbappid String 50 Y facebook用户第一次玩的游戏的facebook appid，facebook中申请的appid,类似入口名称
facebook_id String 50 Y facebook用户第一次玩的游戏的facebookid
entry_lang String 50 N pt/en
entry_type String 50 N 入口类型 （ios：Appstore、androiddata:Google play）
entry_name String 50 N 游戏包名
source String 50 Y 下载渠道
mainsource String 50 N 入口主渠道
subsource String 50 N 入口子渠道
first_name String 50 Y first_name
last_name String 50 Y last_name
middle_name String 50 Y middle_name
name String 50 Y name
short_name String 50 Y short_name
name_format String 50 Y name_format
home_page String 50 N 用户主页
sex String 50 N 性别
birthday String 50 N 生日
picture String 50 N facebook头像
email String 50 Y facebook邮箱
location String 50 N facebook用户地址
locale String 50 N 地区
regip String 50 N 注册ip
regdate String 50 Y 注册时间
sign String 50 Y 数字签名：双方需要验证此信息的正确性
签名方法

所有字段按照字典顺序排序后经过两次md5加密 sign=md5(md5(“key1=value1&key2=value2&$key”)) 加密key直接拼接在字符串后

Status：200、100、101……108、109、（见返回值代码说明）
data: uid、gidloginid

成功后 返回json串其中status状态码,uid为用户ID，gidloginid为用户gidloginlog的id

UC接收Account Kit信息接口

https://tecnofut.xcloudgame.com/Pt/getaccountkit

参数名 参数类型 最大长度 是否必填 描述
gameid String 50 Y 游戏id（15）
accountkit_id String 50 N Account Kit 唯一标识
phone_number String 50 Y Account Kit 手机号
entry_lang String 50 Y pt/en
first_name String 50 Y facebook first_name
entry_type String 50 Y 入口类型 （ios：Appstore、androiddata:Google play）
entry_name String 50 Y 游戏包名
device int 10 Y 设备信息（ios/android）json数据 不参与加密
source int 10 Y 下载渠道 不参与加密
mainsource int 10 Y 主渠道 不参与加密
subsource int 10 Y 子渠道 不参与加密
time int 11 Y 操作时间 unix 时间戳（以秒为单位)
sign String 50 Y 数字签名：双方需要验证此信息的正确性
签名方法

所有字段按照字典顺序排序后经过两次md5加密 sign=md5(md5(“key1=value1&key2=value2&$key”)) 加密key直接拼接在字符串后

Status：200、100、101……108、109、（见返回值代码说明）
data: uid

成功后 返回json串其中status状态码,uid为用户ID

UC接收Google用户信息接口

https://tecnofut.xcloudgame.com/Pt/getgoogle

参数名 参数类型 最大长度 是否必填 描述
gameid String 50 Y 游戏id（15）
person_id String 50 N Google用户 唯一标识
display_name String 50 Y 用户名
family_name String 50 Y 姓
given_name String 50 Y 名
email String 50 Y 邮箱
photo String 50 Y 头像 (不参与加密)
entry_lang String 50 Y pt/en
first_name String 50 Y facebook first_name
entry_type String 50 Y 入口类型 （ios：Appstore、androiddata:Google play）
entry_name String 50 Y 游戏包名
device int 10 Y 设备信息（ios/android）json数据 不参与加密
source int 10 Y 下载渠道 不参与加密
mainsource int 10 Y 主渠道 不参与加密
subsource int 10 Y 子渠道 不参与加密
time int 11 Y 操作时间 unix 时间戳（以秒为单位)
sign String 50 Y 数字签名：双方需要验证此信息的正确性
签名方法

所有字段按照字典顺序排序后经过两次md5加密 sign=md5(md5(“key1=value1&key2=value2&$key”)) 加密key直接拼接在字符串后

Status：200、100、101……108、109、（见返回值代码说明）
data: uid

成功后 返回json串其中status状态码,uid为用户ID

接收ios设备信息接口

https://tecnofut.xcloudgame.com/Pt/getios

参数名 参数类型 最大长度 是否必填 描述
devicename String 50 Y 设备名称（XXX的手机）
sysname String 50 N 系统名称（iPhone OS）
sysversion String 50 Y 系统版本（9.2）
deviceuuid String 50 Y 设备唯一标识
devicemodel String 50 Y 手机类型（iPhone 6 plus）
ua String 50 Y 客户ua
carriername String 50 Y carriername
mobilecountrycode String 50 Y mobilecountrycode
mobilenetworkcode String 50 Y mobilenetworkcode
isocountrycode String 50 Y isocountrycode
ip String 50 Y 客户ip
time int 11 Y 操作时间 unix 时间戳（以秒为单位)
sign String 50 Y 数字签名：双方需要验证此信息的正确性
签名方法

所有字段按照字典顺序排序后经过两次md5加密 sign=md5(md5(“key1=value1&key2=value2&$key”)) 加密key直接拼接在字符串后

Status：200、100、101……108、109、（见返回值代码说明）

成功后 返回json串其中status状态码

接收安卓设备信息接口

https://tecnofut.xcloudgame.com/Pt/getandroid

参数名 参数类型 最大长度 是否必填 描述
imei String 50 Y IMEI号
model String 50 N 手机型号
width String 50 Y 手机内置分辨率getWidth
height String 50 Y getHeight
simoperatornam String 50 Y 运营商名字
time int 11 Y 操作时间 unix 时间戳（以秒为单位)
sign String 50 Y 数字签名：双方需要验证此信息的正确性
签名方法

所有字段按照字典顺序排序后经过两次md5加密 sign=md5(md5(“key1=value1&key2=value2&$key”)) 加密key直接拼接在字符串后

Status：200、100、101……108、109、（见返回值代码说明）

成功后 返回json串其中status状态码

下单接口

https://tecnofut.xcloudgame.com/Pt/order

参数名 参数类型 最大长度 是否必填 描述
uid string 20 Y 用户UID
role_name string 100 Y 用户游戏角色名称
sid int 10 Y 游戏服ID
gid int 10 Y 游戏编号
app_id string 20 Y app编号
game_order string 20 Y 游戏订单号
amount float 保留两位小数 Y 订单金额
currency 金额币种 金额币种 Y 币种（e.g. BRL）
game_money int 11 Y 游戏币数量
product_id string 100 Y 商品编码
game_good_id int 10 Y 套餐编号（无默认1）
channel string 20 Y 下单渠道
data string 100 Y 传递参数
time int 11 Y 用户注册时间 unix 时间戳（以秒为单位)
sign String 50 Y 数字签名：双方需要验证此信息的正确性
签名方法

所有字段按照键值排序后经过两次md5加密 sign=md5(md5(“key1=value1&key2=value2&$key”)) 加密key直接拼接在字符串后

Status：200、100、101……108、109、（见返回值代码说明）

成功后 返回json串其中status状态码，order_id 是支付成功返回的订单号

google 支付验证接口

https://tecnofut.xcloudgame.com/Googlepay/check

参数名 参数类型 最大长度 是否必填 描述
uid string 20 Y 用户UID
gid int 10 Y 游戏编号
package_name string 50 Y 包名字
product_id string 50 Y google product
app_id string 20 Y app编号
token string 20 Y google 验证token
game_order string 20 Y 游戏订单号
google_order string 20 Y 谷歌订单号
time int 11 Y 验证时间 unix 时间戳（以秒为单位)
sign string 50 Y 数字签名：双方需要验证此信息的正确性
签名方法

所有字段按照键值排序后经过两次md5加密 sign=md5(md5(“key1=value1&key2=value2&$key”)) 加密key直接拼接在字符串后

apple pay 支付验证接口

https://tecnofut.xcloudgame.com/Applepay/check

参数名 参数类型 最大长度 是否必填 描述
uid string 20 Y 用户UID
gid int 10 Y 游戏编号
package_name string 50 Y apple pay bid
product_id string 50 Y apple pay product
token string 20 Y apple pay 验证token
game_order string 20 Y 游戏订单号
time int 11 Y 验证时间 unix 时间戳（以秒为单位)
sign string 50 Y 数字签名：双方需要验证此信息的正确性
签名方法

所有字段按照键值排序后经过两次md5加密 sign=md5(md5(“key1=value1&key2=value2&$key”)) 加密key直接拼接在字符串后

订单状态查询接口

https://tecnofut.xcloudgame.com/Pt/checkorder

参数名 参数类型 最大长度 是否必填 描述
uid string 20 Y 用户UID
gid int 10 Y 游戏编号
game_order string 20 Y 游戏订单号
sign string 50 Y 数字签名：双方需要验证此信息的正确性
签名方法

所有字段按照键值排序后经过两次md5加密 sign=md5(md5(“key1=value1&key2=value2&$key”)) 加密key直接拼接在字符串后

Status：200、100、101……108、109、（见返回值代码说明）

成功后 返回json串其中status状态码,200为支付成功

发奖接口（非必须）

参数名 参数类型 最大长度 是否必填 描述
uid string 20 Y 用户UID
sid int 10 Y 游戏服ID
gid int 10 Y 游戏编号
app_id string 20 Y app编号
game_order string 20 Y 游戏订单号
amount float 保留两位小数 Y 订单金额
currency 金额币种 金额币种 Y 币种（e.g. USD）
game_money int 11 Y 游戏币数量
game_good_id int 10 Y 套餐编号（无默认1）
channel string 20 Y 下单渠道
data string 100 N 传递参数
sign String 50 Y 数字签名：双方需要验证此信息的正确性
签名方法

所有字段按照键值排序后经过两次md5加密 sign=md5(md5(“key1=value1&key2=value2&$key”)) 加密key直接拼接在字符串后

Status：200、100、101……108、109、（见返回值代码说明）

游客账户生成接口

https://tecnofut.xcloudgame.com/Pt/tourist

参数名 参数类型 最大长度 是否必填 描述
device String 260 Y 设备信息（ios/android）json数据 不参与加密
entry_lang String 50 N pt/en
entry_type String 50 N FB/LP/XC 目前是这三种类型
entry_name String 50 N 游戏的多个马甲包名字
source String 50 Y 下载渠道
mainsource String 50 N 入口主渠道
subsource String 50 N 入口子渠道
gameid int 11 Y 游戏ID（游戏1、游戏2……）
time int 11 Y 用户注册时间 unix 时间戳（以秒为单位)
sign String 50 Y 数字签名：双方需要验证此信息的正确性
签名方法

所有字段按照字典顺序排序后经过两次md5加密 sign=md5(md5(“key1=value1&key2=value2&$key”)) 加密key直接拼接在字符串后

Status：200、100、101……108、109、（见返回值代码说明）
data: uid，gidloginid

成功后 返回json串其中status状态码,uid为用户ID,

游客绑定接口

https://tecnofut.xcloudgame.com/Pt/touristdb

参数名 参数类型 最大长度 是否必填 描述
facebook_id String 50 Y Facebook用户的facebook_id
token_for_business String 50 Y Facebook用户的唯一标识
uid string 20 Y 游客标识
time int 11 Y 用户注册时间 unix 时间戳（以秒为单位)
sign String 50 Y 数字签名：双方需要验证此信息的正确性
签名方法

所有字段按照字典顺序排序后经过两次md5加密 sign=md5(md5(“key1=value1&key2=value2&$key”)) 加密key直接拼接在字符串后

Status：200、100、101……108、109、（见返回值代码说明）
data: uid

成功后 返回json串其中status状态码,uid为用户ID

写入角色信息

https://tecnofut.xcloudgame.com/Pt/userinfo

参数名 参数类型 最大长度 是否必填 描述
uid String 50 Y uid
sid String 50 Y 游戏服id
rolename string 20 Y 角色名
pid string 20 Y 游戏pid
grade string 20 Y 等级
combat string 20 Y 战力
vip string 20 Y VIP等级
moditime string 20 Y 修改时间
entry_type string 20 Y 入口类型
sign String 50 Y 数字签名：双方需要验证此信息的正确性
签名方法

所有字段按照字典顺序排序后经过两次md5加密 sign=md5(md5(“key1=value1&key2=value2&$key”)) 加密key直接拼接在字符串后

Status：200、100、101……108、109、（见返回值代码说明）

成功后 返回json串其中status状态码

角色升级修改信息

https://tecnofut.xcloudgame.com/Pt/userup

参数名 参数类型 最大长度 是否必填 描述
uid String 50 Y uid
sid String 50 Y 游戏服id
rolename string 20 Y 角色名
pid string 20 Y 游戏pid
grade string 20 Y 等级
combat string 20 Y 战力
vip string 20 Y VIP等级
moditime string 20 Y 修改时间
entry_type string 20 Y 入口类型
sign String 50 Y 数字签名：双方需要验证此信息的正确性
签名方法

所有字段按照字典顺序排序后经过两次md5加密 sign=md5(md5(“key1=value1&key2=value2&$key”)) 加密key直接拼接在字符串后

Status：200、100、101……108、109、（见返回值代码说明）

成功后 返回json串其中status状态码

埋点接口

https://tecnofut.xcloudgame.com/Pt/buried

参数名 参数类型 最大长度 是否必填 描述
uid String 50 Y uid
mark String 50 Y 设备唯一标识（不参与加密）
sid String 50 Y 游戏服id
mainclass string 20 Y 主类
subclass int 11 Y 子类
entry_type int 11 Y 入口类型
moditime int 11 Y 修改时间
sign String 50 Y 数字签名：双方需要验证此信息的正确性
签名方法

所有字段按照字典顺序排序后经过两次md5加密 sign=md5(md5(“key1=value1&key2=value2&$key”)) 加密key直接拼接在字符串后

Status：200、100、101……108、109、（见返回值代码说明）

成功后 返回json串其中status状态码

接收source接口（用于补全获取source失败的用户的source）

https://tecnofut.xcloudgame.com/Pt/getsource

参数名 参数类型 最大长度 是否必填 描述
uid String 50 Y uid
gidloginid String 50 Y gidloginid
only String 50 Y 设备唯一标识
source string 20 Y 渠道（不参与加密）
mainsource int 11 Y 主渠道（不参与加密）
subsource int 11 Y 子渠道（不参与加密）
time int 11 Y 时间
sign String 50 Y 数字签名：双方需要验证此信息的正确性
签名方法

所有字段按照字典顺序排序后经过两次md5加密 sign=md5(md5(“key1=value1&key2=value2&$key”)) 加密key直接拼接在字符串后

Status：200、100、101……108、109、（见返回值代码说明）

成功后 返回json串其中status状态码

添加分享图片

https://tecnofut.xcloudgame.com/Pt/upload

参数名 参数类型 最大长度 是否必填 描述
filename String 50 Y 表单name名字（input标签name的值）filename中的点(.)换成下划线(_)
imagecode String 50 Y 分享的类型1、2、3……
time int 11 Y 时间
sign String 50 Y 数字签名：双方需要验证此信息的正确性
签名方法

所有字段按照字典顺序排序后经过两次md5加密 sign=md5(md5(“key1=value1&key2=value2&$key”)) 加密key直接拼接在字符串后

Status：200、100、101……108、109、（见返回值代码说明）
url:图片链接
imagetitle:图片标题
imagesubtitle:图片描述

成功后 返回json串其中status状态码

获取分享图片和内容

https://tecnofut.xcloudgame.com/Suspension/share

参数名 参数类型 最大长度 是否必填 描述
type int 11 Y 分享类型
time int 11 Y 时间
sign String 50 Y 数字签名：双方需要验证此信息的正确性
签名方法

所有字段按照字典顺序排序后经过两次md5加密 sign=md5(md5(“key1=value1&key2=value2&$key”)) 加密key直接拼接在字符串后

Status：200、100、101……108、109、（见返回值代码说明）
url:图片链接
imagetitle:图片标题
imagesubtitle:图片描述

成功后 返回json串其中status状态码

获取cdk

https://tecnofut.xcloudgame.com/Suspension/share_cdk

参数名 参数类型 最大长度 是否必填 描述
uid String 50 Y 用户uid
gameid int 11 Y 游戏id
type string 50 Y whatsapp、messenger
time int 11 Y 时间
sign String 50 Y 数字签名：双方需要验证此信息的正确性
签名方法

所有字段按照字典顺序排序后经过两次md5加密 sign=md5(md5(“key1=value1&key2=value2&$key”)) 加密key直接拼接在字符串后

Status：200、100、101……108、109、（见返回值代码说明）
cdk:兑换码

成功后 返回json串其中status状态码

绑定登录方式

https://tecnofut.xcloudgame.com/Suspension/login_method

参数名 参数类型 最大长度 是否必填 描述
uid String 50 Y 用户uid
type int 50 Y 1:facebook、2：google、3:accountkit
time int 11 Y 时间
sign String 50 Y 数字签名：双方需要验证此信息的正确性

注：type=1，（以下参数不参与加密）

参数名 参数类型 最大长度 是否必填 描述
facebook_id String 50 Y Facebook ID
token_for_business String 50 Y Facebook 唯一标识

注：type=2，（以下参数不参与加密）

参数名 参数类型 最大长度 是否必填 描述
email String 50 Y Google email
person_id String 50 Y Google 唯一标识

注：type=3，（以下参数不参与加密）

参数名 参数类型 最大长度 是否必填 描述
phone_number String 50 Y accountkit 手机号
accountkit_id String 50 Y accountkit 唯一标识
签名方法

所有字段按照字典顺序排序后经过两次md5加密 sign=md5(md5(“key1=value1&key2=value2&$key”)) 加密key直接拼接在字符串后

Status：200、100、101……108、109、（见返回值代码说明）
cdk:兑换码

成功后 返回json串其中status状态码

错误码

错误码 描述  
100 email信息不全  
101 password信息不完整 ·
102 facebook账号重复  
103 password 错误  
104 time信息不完整  
105 sign信息不完整或信息有误  
106 数据库操作失败  
107 分区信息不全  
108 Key错误  
109 sid 有误  
110 app_id 有误  
111 game_order为空  
112 game_order重复  
113 amout 或currency错误  
114 需求参数为空  
115 game_money 或game_good_id有误  
116 用户不存在  
117 系统错误  
118 渠道订单异常  
119 验证异常  
120 支付失败或未支付  
121 当日已经分享过了  
122 cpf已经验证过了  
123 cpf错误  
124 uid未注册  
125 账号已被绑定或注册  
126 cep 无效  
127 cdk 没有库存