游戏礼包
接口说明
用户在获取到礼包兑换码进入游戏后,发起核销兑换码的动作,开发者需要使用本接口校验礼包兑换码的有效性。校验通过后才可以发放对应礼包。
前提条件
无
基本信息
名称 | 描述 |
---|---|
HTTP URL | https://minigame.zijieapi.com/mgplatform/api/gift/receive_reward |
HTTP Method | POST |
Scope | open.ttgame.mgplatform |
权限要求 | 兑换福袋 |
请求参数
请求头
access-token必填String
示例:08011218462b6b4b5054626e426e50685a7554643144644449413d3d
content-type必填String
固定值"application/json"
Body
gift_code必填String
cdk
open_id必填String
兑奖用户的OpenID
uuid必填String
开发者厂商侧传入,幂等
env_typeString
环境类型
该字段通过 tt.getEnvInfoSync 接口返回的 unkown 字段获取
请求示例
curl --location --request POST '/mgplatform/api/gift/receive_reward' \ --header 'content-type: application/json' \ --data '{"env_type":"S3tlqwlemP","Base":{"Client":"Hfu4UcFIhL","TrafficEnv":{"Env":"VnFfTJno2N","Open":false},"Extra":{"o8Lphjd048":"WW7zTuayiq"},"LogID":"HRd9RgCdEB","Caller":"MSJ7VEqAUS","Addr":"JcIpyvpo8P"},"uuid":"nInvk4VGVQ","open_id":"hCjIrXj3iN","gift_code":"YBcN93vySi"}' # 此示例仅为模板,请修改为更加符合业务规则的调用示例,方便开发者查看
响应参数
Body展开全部子属性
err_msg必填String
err_no必填Int32
gift_infoStruct
展开子属性
响应示例
{ "err_no": 2043767929220280000, "err_msg": "HGxschUEqo", "BaseResp": { "StatusMessage": "lGBX0DmPAk", "StatusCode": 5674369588381848000, "Extra": { "YpFnOk3yTe": "o28s9Ffw3s" } }, "gift_info": { "amount": 8848608659262647000, "remain_stock": 7194468339706529000, "background_url": "FDPbaRIj6e", "can_receive": false, "gift_id": "5AeLDk3U7S", "gift_effective_end_time": 8382387573794567000, "received": false, "gift_effective_start_time": 3393750001762168000, "play_type": 1, "origin_amount": 8160300295147774000, "rgb": 8862411740157691000, "name": "mjitnCB1M8", "user_receive_guide": [ "34QNOf6lgL" ], "diamond_amount": 6893052298198705000, "icon_url": "zAvxdPz1AT", "prop_list": [ { "count": 7304279378011784000, "prop_id": "V0ApE2XFBK", "name": "hbrxAaROL7", "icon": "d556XLZmWo" } ] } }
错误码
HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
---|---|---|---|
200 | 28001005 | 系统内部错误,请重试 | 请求重试,若依然无解请向平台提交反馈 |
200 | 28001003 | access_token无效 | 重新请求生成access_token |
200 | 28001008 | access_token过期,请刷新或重新授权 | 重新请求生成access_token |
200 | 28001006 | 网络调用错误,请重试 | 重试即可 |
200 | 28001007 | 参数错误 | 请仔细检查相关参数 |
200 | 28006040 | 礼包码重复核销 | 该券已经提交过核销记录,无需再提交 |
200 | 28006041 | 礼包码与open_id的绑定关系有误 | 礼包码与open_id的绑定关系有误,请再次确认 |