# 礼包接收接口
接口地址:接入方提供
请求方式: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
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
2
3
4
5
# 接收接口签名算法
按照当前请求参数名的字母序进行升序排列(排序时区分大小写,signature和value为空的参数不参与签名),将所有参数-值组合以 key=value 的形式拼成一个新字符串,不同参数值之间没有任何分隔符,最后加上对应的签名密钥 secretKey(此密钥在接入时由游戏方提供给gipp相关开发人员) 进行MD5哈希运算。如进行签名运算的串为:key1=value1key2=value2secretKey 输出为:F025850631E476038D0F549876951ED;
← 服务端 API 说明 系统概述 →