产品列表【购买限制时用】

接口描述

支付中心使用,用户可购买的商品列表,针对有商品限制购买时间、次数、等级等要求的使用

例如:XXX道具限制用户仅购买一次,如果用户已经购买过则返还该商品不可以购买

请求方式:get

接口通知参数数据描述

参数
Y必须/N选填
类型
描述

site

Y

string

默认R2Games

game

Y

string

双方约定

serverid

Y

string

服务器ID

roleid

N

string

玩家游戏内唯一角色标示ID

rolename

N

string

玩家角色名

username

N

string

R2方账号uid,即 r2uid

time

Y

int

Unix时间戳,超时验证,10分钟内有效

sign

Y

string

数据签名

roleid,rolename,username必须填其中的一个或多个,每个游戏条件不同,可以做对应选择

MD5签名

示例数据

apiKey:abcd (该秘钥仅供演示使用)

  1. 所有请求参数去掉空参数,sign不参与签名;

  2. 将参数按key的assic码升序排序,比如{key1:value1,key2:value2}

  3. 连接对应value值如value1value2,注意值中有中文等特殊符号的无需urlencode;

  4. 第3步生成的字符串直接拼接,末尾连接apiKey,然后进行md5(value1value2abcd),即可得到sign。

返回数据说明 json

参数
Y必须/N选填
类型
描述

status

Y

int

0成功1参数错误2用户不存在3请求超时4调用失败

msg

Y

string

success/fail

data

Y

Object[]

数据列表

data的Object数据

参数
Y必须/N选填
类型
描述

productId

Y

string

商品ID

productName

Y

string

游戏内的商品名称

summary

N

string

商品内容、描述

price

N

string

商品价格

image

N

string

商品图片地址

tag

N

string

标签,现有标签为:currency、gift、superGift 、bounty currency :货币 gift :礼包 superGift :超级礼包 bounty:赏金

productExtend

N

string

研发的产品ID扩展参数,相同商品ID对应不同多个礼包码场景使用,如果有返还并且不为空下单接口传递给研发

status

Y

string

商品状态 enabled可购买 disabled不可购买

返回示例:

{"status":0,"msg":"success","data":[{"productId":"xxxx.xxx.109","productName":"Diamonds","summary":"Diamonds*1000","price":"0.99","image":"http://cdn.xxxx.com/xx.png","tag":"currency","productExtend":"2"},{"productId":"xxxx.xxx.110","productName":"Experience package","summary":"Experience *1000","price":"0.99","image":"http://cdn.xxxx.com/xx.png","tag":"gift","productExtend":""}]}

Last updated

Was this helpful?