SDK服务端接入文档

果盘与游戏合作方服务端间接口说明

一、 文档说明

1.1 功能描述

本文档主要是果盘与游戏合作方(SDK使用者)的服务端之间的接口交互说明。

1.2 阅读对象

游戏合作方服务端开发相关技术人员

1.3 业务术语

无

二、果盘服务端用户有效性验证接口

2.1 URL

http(s)://userapi.guopan.cn/gamesdk/verify/

2.2 HTTP请求方式

GET

2.3 请求参数

必选

类型及范围

说明

game_uin

true

string

果盘分配给该游戏对应的唯一账号，16至18位长字符，可通过客户端SDK方法获取得到。

安卓：IGPApi

+(String)getLoginUin()

iOS： [GPGameSDK defaultGPGame].loginUin

appid

true

string

token

true

string

可通过客户端SDK方法获取得到。

t

true

string

时间戳(请填写服务器发起请求的北京时间，单位秒)

sign

true

string

加密串sign=md5(game_uin+appid+t+SERVER_KEY) 是四个变量值拼接后经md5后的值，其中SERVER_KEY在果盘开放平台上获得。

2.4 返回结果

结果

说明

true

成功

false

失败

-1

加密串验证失败

-2

APPID不存在

2.5 注意事项

验证失败检查步骤

1.检查appid对应的SERVER_KEY是否正确

2.参数t 时间戳的单位为秒

3.token每次登录后都会刷新，需要获取最新的token来校验

4.如果以上三步都确认正确，麻烦把加密前的字符串打印一下提供给我方技术查看

2.6 例子

http://userapi.guopan.cn/gamesdk/verify/?game_uin=2V16YOP6FRS11H5O&appid=101101&token=Login_119_101101_ed42ccb2a31b76e31b4e66bd8461e56a&t=1416811075&sign=2847039fa75dded7ec23cf006171a423

注: 上述例子中appid=101101的SERVER_KEY是字符串 3JOVFPIVV7UF203QMLR6T6ED8888LIAI0MZY776UYYTGERPKW9RL8AH57WUTY28K

三、果盘服务端订单状态查询接口

3.1 URL

http://open.guopan.cn/api2/gp_sdk_order_status.php

3.2 HTTP请求方式

GET

3.3 请求参数

必选

类型及范围

说明

serialNumber

true

string

游戏方订单序列号

appid

true

string

t

true

string

时间戳(请填写服务器发起请求的北京时间)

sign

true

string

加密串sign=md5(appid+ serialNumber +t+SERVER_KEY) 是四个变量值拼接后经md5后的值，其中SERVER_KEY在果盘开放平台上获得。

3.4 返回结果

结果

说明

success,[状态码]

[状态码]=0 失败；

[状态码]=1 成功；

[状态码]=2 失败，原因是余额不足。

fail,-1

超时 t参数时间相差超过30秒

fail,-2

APPID不存在

fail,-3

APPID状态已失效

fail,-4

加密串验证失败

3.5 注意事项

当游戏合作商接收到"SDK服务器"支付回调后，为了防止因密钥泄露产生第三方恶意通知发货，游戏合作商可在收到支付回调请求后，调用此接口校验是否支付成功，验证成功后再进行发货。

3.6 例子

http://open.guopan.cn/api2/gp_sdk_order_status.php? serialNumber=1416466410_101101_41VW940DVGJ8L8&appid=101101&t=1416811757&sign=f72268f4bfd44062d26c9a0ebf95728d

注: 上述例子中appid=101101的SERVER_KEY是字符串 3JOVFPIVV7UF203QMLR6T6ED8888LIAI0MZY776UYYTGERPKW9RL8AH57WUTY28K

四、游戏服务端订单通知接口

4.1 URL

由游戏合作方在果盘开放平台填写。

4.2 HTTP请求方式

POST

4.3 请求参数

必选

类型及范围

说明

trade_no

true

string

果盘唯一订单号

serialNumber

true

string

游戏方订单序列号

money

true

string

消费金额。单位是元，精确到分，如10.00。

status

true

string

状态；0=失败；1=成功；2=失败，原因是余额不足。

t

true

string

时间戳(果盘服务器发起通知的北京时间)

sign

true

string

加密串 sign=md5(serialNumber +money+status+t+SERVER_KEY) 是五个变量值拼接后经md5后的值，其中SERVER_KEY在果盘开放平台上获得。

appid

false

string

item_id

false

string

item_price

false

string

item_count

false

string

reserved

false

string

扩展参数，SDK发起支付时有传递，则这里会回传。

game_uin

true

string

玩家游戏uid

use_voucher

false

string

合作代金券消费的金额(单位:元)，默认0.00 (目前用于果盘发行渠道)

4.4 返回结果

返回结果包含有字符串” success”则果盘服务端认为游戏服务端已经准确接收到我们的通知；否则 果盘服务端会隔一定时间再次通知游戏服务端。

注: 一直未接收到包含”success”的返回，果盘会每1分钟通知一次；10次后,更改为1小时通知一次；20次后更新为一天通知一次，直到30次为止。

4.5 注意事项

防“任意充”提醒：请务必校验game_uin参数与下单用户的game_uin是否一致，如果不一致，很有可能是“任意充”，此时可不下发道具。

五、防沉迷实名信息查询接口

5.1 请求方式

HTTP GET

5.2 URL

http://userapi.guopan.cn/gamesdk/cert

5.4 请求参数

字段名

数据类型

说明

game_uin

string

果盘分配给该游戏对应的唯一账号，16至18位长字符，可通过客户端SDK方法获取得到。

安卓：IGPApi

+(String)getLoginUin()

iOS： [GPGameSDK defaultGPGame].loginUin

appid

string

token

string

通过客户端SDK方法获取得到

t

string

时间戳（单位秒，请填写服务器发起请求的北京时间）

sign

string

加密串 sign=md5(game_uin+appid+t+SERVER_KEY) 是四个变量值拼接后经 md5 后的值，

其中 SERVER_KEY 在果盘开放平台上获得。

5.5 返回结果（json）

示例：

{

"code":0,

"data":{

"game_uin":"EI3N292NNJ88",

"age":30,

"oversea":false,

"id_type":0,

"id":"222303483232234257",

"verify_status":2,

"birthday":"19950614"

"pi":"",

},

"msg":""

}

字段名

数据类型

中文含义

参数说明

备注

game_uin

string

渠道游戏账号唯一标识

age

int

当前账号实名登记年龄

oversea

bool

是否是海外用户

true：海外用户

false：非海外用户

id_type

int

证件类型

0：身份证

1：中国护照

2：海外护照

3：其他

id

string

证件号码

身份证号码

verify_status

int

用户实名信息完善情况/验证结果

0：用户未提供实名认证信息

1：用户已提供实名信息，但未经过权威接口验证
2：经权威接口验证通过 
3：经权威接口验证失败

birthday

string

用户当前生日

20010102（即yyyyMMdd）

pi

string

中宣部实名认证系统的用户身份唯一标识值

5.6 注意事项：

id字段返回的可能并非用户身份证号码原文，可能是经过特定算法脱敏后的唯一身份证值。

六、附录

如遇到其他问题，请邮件联系chunhui.zhang@flamingo-inc.com

相关知识

果盘SDK接入文档 for Android
游戏SDK怎么接入？游戏SDK接入全攻略
ios 游戏sdk接入 游戏sdk接入流程
游戏sdk是什么接入sdk是什么意思
Unity游戏接入SDK的方法。
什么是手游SDK？为什么要接入？
游戏盾 隧道加密 sdk
游戏sdk开发
手游sdk是什么意思 手游sdk接入教程
游戏代理平台SDK是什么意思