空间小游戏

空间H5游戏-后台接口

/v3/user/buy_playzone_item

pf=qzone pf=wanba_ts pf=weixin

使用积分(余额)兑换指定游戏的道具。

URL

https://api.urlshare.cn/v3/user/buy_playzone_item

私有参数

参数名称 是否必须 类型 描述
openid 是 string QQ号码转化得到的ID
zoneid 是 int 区ID，用于区分用户是在哪一款平台下(Android、IOS等)，IOS填2，Android填1
billno 是 string 订单号，业务需要确保全局的唯一性；相同的订单号不会重复扣款。长度不超过40字节，数字和字符不限，不能包含特殊字符如& = | % ^ + 等即可（有效期48小时）
appid 是 sting 游戏ID
itemid 是 string 道具ID
count 否 int 兑换道具数量
qua 否 string 用于统计

请求示例

https://api.urlshare.cn/v3/user/buy_playzone_item?
billno=xxxxx&
openid=B624064BA065E01CB73F835017FE96FA&
zoneid=1&
openkey=5F154D7D2751AEDC8527269006F290F70297B7E54667536C&
appid=2&
itemid=10&
count=1&
sig=VrN%2BTn5J%2Fg4IIo0egUdxq6%2B0otk%3D&
pf=wanba_ts&
format=json&
userip=112.90.139.30

返回参数说明

参数名称 描述
code 返回码。详见公共返回码说明#OpenAPI V3.0 返回码
subcode 返回码子码
message 如果错误，返回错误信息。
billno 系统实际支付订单号（如果为空时也属于异常）
isWhiteListUser 白名单用户标识
cost 兑换耗费的实际积分，只是个反馈，不要依赖这个值来发货

错误返回码说明

本接口私有错误返回码：

  • 2000:uin错误
  • 2001:区ID错误
  • 2002:账户不存在
  • 2003:游戏ID错误
  • 2004:道具ID错误
  • 2005:道具兑换量错误
  • 2006:道具库存不足
  • 2007: 物品价格错误
  • 2008：生成订单号错误
  • 2017：没有传订单号
  • 2018：重复或已经支付成功
  • 2019：账户系统繁忙，用同一订单号进行重试，避免道具不到账
  • 2020：订单号长度过长

正确返回示例

{
"code":0,
"subcode":0,
"message":"",
"default":0,
"data":
[{
"billno":1234,
"cost":"1000"
}]
};