空间小游戏

空间H5游戏-后台接口

/v3/user/gift_exchange

pf=qzone pf=wanba_ts

积分兑换礼包，vip礼包兑换时必须调用此接口进行权限校验，积分扣除等操作

URL

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

私有参数

参数名称 是否必须 类型 描述
appid 是 string 游戏id
gift_id 是 string 积分礼包或者vip礼包id
qua 否 string 用于统计

请求示例

http://api.urlshare.cn/v3/user/gift_exchange?sig=S99eUI5F%2Bwt6Lzq4BL4GUxA3kDo%3D&appid=1105583577&gift_id=1234&qua=V1_IPH_SQ_7.1.1_1_APP_A&openid=80892B0A8ABF68332709B64C3E23860F&openkey=FDFE4C7D039ADB5580B843615A520438&pf=wanba_ts&format=json&userip=

返回参数说明

参数名称 描述
ret 返回码
msg 返回信息

错误返回码说明

本接口私有错误返回码：

  • 2000 系统繁忙
  • 2001 参数错误
  • 2002 拉取礼包数据出错
  • 2003 礼包兑换达到上限
  • 2004 非积分兑换礼包及VIP礼包，无需校验
  • 2005 积分不足，无法兑换积分礼包（只针对积分礼包）
  • 2006 用户非VIP，无法兑换VIP礼包（只针对VIP礼包）
  • 2007 用户VIP等级与VIP礼包等级不符，无法兑换（只针对VIP礼包）
  • 2008 礼包已过期
  • 2009 单用户兑换积分礼包次数限制（只针对积分礼包）

正确返回示例

{
  "ret":0,
  "msg":"succ"
}