# 礼包接收接口

接口地址:接入方提供

请求方式:POST

请求数据类型:content-type=formurlencoded

响应数据类型:*/*

接口描述:

用于接收GIPP通知发货的接口

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
uniqueId 渠道方/用户平台请求编号 query true string
orderId 发货唯一凭证(gipp订单号) query true string
channelType 认证系统的渠道标识 query true string
platform 平台标识:2:安卓,3:iOS,-1:未知 query true int
appId 游戏id query true string
areaId 区ID query true string
groupId 组ID query false string
itemInfo 道具信息,由平台将道具信息组织为Json后发送至游戏方 query true string
giftPackageId 礼包ID query true string
giftPackageName 礼包名称 query false string
giftType 礼包类型 query true string
userId 用户信息,与userIdType合用 query true string
userIdType 1:mid(手游)ptid(端游)2:sndaId 3:渠道账号Id 4:appMid 99:游戏帐号。(目前手游只有4) query true string
roleId 游戏角色Id query true string
eventTimestamp 礼包领取时间(yyyy-MM-dd HH:mm:ss) query true string
extend 扩展字段(json), 游戏方如需使用此字段,请与GIPP平台开发沟通协调 query false string
deliverExtend 发货扩展信息, 原样传回 query false string
signature 接口签名,MD5哈希。此接口MD5哈希密钥开发方提供 query true string

响应参数:

参数名称 参数说明 类型 schema
resultCode 响应代码(0为成功) int
resultMsg 响应信息 string

响应示例:

{
	"resultCode":0,	"resultMsg":""
}
1
2
3

# 获取用户在指定区服的角色列表

接口地址:接入方提供(非必须)

请求方式:GET

响应数据类型:*/*

接口描述:

获取用户在指定区服的角色列表

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
uniqueId 渠道方/用户平台请求编号 query true string
channelType 认证系统的渠道标识 query true string
platform 平台标识:2:安卓,3:iOS,-1:未知 query true int
appId 游戏id query true string
areaId 区ID query true string
groupId 组ID query false string
userId 用户信息,与userIdType合用 query true string
userIdType 1:mid(手游)ptid(端游)2:sndaId 3:渠道账号Id 4:appMid 99:游戏帐号。(目前手游只有4) query true string

响应参数:

参数名称 参数说明 类型 schema
resultCode 响应代码(0为成功) int
resultMsg 响应信息 string
roleList 角色信息 string jsonstring

响应示例:

{
	"resultCode":0,	
	"resultMsg":"",
	"roleList":"[{\"areaId\":\"1\",\"areaName\":\"区1\",\"roleId\":\"1\",\"roleName"\:\"1\",\"roleLevel\":1},{\"areaId\":\"2\",\"areaName\":\"区2\",\"roleId\":\"2\",\"roleName\":\"2\",\"roleLevel\":2}]"
}
1
2
3
4
5

# 接收接口签名算法

按照当前请求参数名的字母序进行升序排列(排序时区分大小写,signature和value为空的参数不参与签名),将所有参数-值组合以 key=value 的形式拼成一个新字符串,不同参数值之间没有任何分隔符,最后加上对应的签名密钥 secretKey(此密钥在接入时由游戏方提供给gipp相关开发人员) 进行MD5哈希运算。如进行签名运算的串为:key1=value1key2=value2secretKey 输出为:F025850631E476038D0F549876951ED;

Last Updated: 2024/5/28 07:10:57