抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 服务端API介绍
  • 小游戏 OpenAPI SDK 总览
  • 接口调用凭证
  • 登录
  • 开放数据
  • 二维码
  • 订阅消息
  • 消息推送客服
  • 游戏礼包
  • 游戏内容安全
  • 推荐流直出游戏能力
  • 动态分享
  • 消息推送
  • 抖音客服平台-客服能力
  • Link链接
  • Schema链接
  • 游戏群标签能力
  • 上报赛事报名用户
  • 选手排名上报
  • 游戏礼包

    收藏
    我的收藏

    接口说明

    用户在获取到礼包兑换码进入游戏后,发起核销兑换码的动作,开发者需要使用本接口校验礼包兑换码的有效性。校验通过后才可以发放对应礼包。

    前提条件

    基本信息

    名称描述
    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 状态码错误码错误码描述排查建议
    20028001005
    系统内部错误,请重试
    请求重试,若依然无解请向平台提交反馈
    20028001003
    access_token无效
    重新请求生成access_token
    20028001008
    access_token过期,请刷新或重新授权
    重新请求生成access_token
    20028001006
    网络调用错误,请重试
    重试即可
    20028001007
    参数错误
    请仔细检查相关参数
    20028006040
    礼包码重复核销
    该券已经提交过核销记录,无需再提交
    20028006041
    礼包码与open_id的绑定关系有误
    礼包码与open_id的绑定关系有误,请再次确认