微信游戏圈任务

全局说明

  • 仅面向“内部版”企业开放。
  • 签名使用的秘钥见 星云开放平台->对接中心->SDK对接，参数App Secret
  • post传参格式使用Content-Type: application/json

    一、时序图

    file

二、红点处理

file

三、接口地址

https://api-combine.feiyu.com

四、签名规则

4.1 MD5签名
4.1.1、获取基础接入参数

在【对接中心->SDK对接->SDK列表】，App ID（请求参数app_id）和App Secret（签名密钥）。

file

4.1.2、签名文档

参考：鉴权指南md5 - v1.1

五、领取奖励接口 (游戏服务端主动调用)

1.描述：此接口用于游戏服务端主动触发奖励领取操作，返回奖励道具列表，供游戏服务端完成道具的发放处理。对应时序图3.2。

2.请求方式：POST

  • 接口地址：/v1/wechatMiniGame/gameClub/rewardCollection
  • 请求头："Content-type":"application/json"
    3.请求参数：

    {
"app_id": "33321",
"channel_id": 1,
"open_id": "70fc606026e2f91a972ac4194cceba5d",
"player_id": "10891",
"server_id": "1",
"sign": "51bd1426f9301e1bf5cd28a99b068d63",
"sign_nonce": "MHwJwza5",
"sign_version": "1.1",
"task_id": 90,
"timestamp": "1752500661",
}
参数名 类型 注释 是否必传
app_id string 游戏ID 是
channel_id int 渠道ID 是
open_id string 用户OpenID 是
task_id int 任务ID 是
server_id string 游戏服ID 是
player_id string 角色ID 是
timestamp int 时间戳（秒） 是
sign string 签名 是
sign_type string 签名类型(默认：md5) 是
sign_nonce string 签名随机数(随机数字+字符串共8位) 是
sign_version string 签名版本，固定值：1.1 是

4.请求成功返回：

{
    "trace_id": "a22929e89b8a0080c416fff3747689e5",
    "status": 0,
    "message": "OK",
    "data": {
        "order_id": "c98a1370-26fe-494f-b3ec-0475d9a61a40",
        "prop_list": [
            {
                "prop_id": "2000001",
                "prop_num": 10
            }
        ]
    }
}

5.错误码：

status 说明
400 错误请求，参数有误
500 未知的服务内部错误（无法拿到明确message，可联系平台研发排查问题）
4000 业务内部错误（能拿到明确message）
4002 签名校验错误

六、道具下发结果回调 (游戏服务端主动调用)

1.描述：此接口用于通知道具下发成功的回调结果。对应时序图3.6。
2.请求方式：POST

  • 接口地址：/v1/wechatMiniGame/gameClub/notifyExchange
  • 请求头："Content-type":"application/json"

3.请求参数：

{
    "app_id": "33321",
    "channel_id": 1,
    "open_id": "70fc606026e2f91a972ac4194cceba5d",
    "order_id": "c98a1370-26fe-494f-b3ec-0475d9a61a40",
    "player_id": "10891",
    "server_id": "1",
    "sign": "e5c0efb49b931b776f46591a6531baa9",
    "sign_nonce": "JYgY1IWb",
    "sign_version": "1.1",
    "task_id": 90,
    "timestamp": "1752500661",
}
参数名 类型 注释 是否必传
app_id string 游戏ID 是
channel_id int 渠道ID 是
open_id string 用户OpenID 是
task_id int 任务ID 是
server_id string 游戏服ID 是
player_id string 角色ID 是
order_id string 订单ID（领取奖励接口返回） 是
timestamp int 时间戳（秒） 是
sign string 签名 是
sign_type string 签名类型(默认：md5) 是
sign_nonce string 签名随机数(随机数字+字符串共8位) 是
sign_version string 签名版本，固定值：1.1 是

4.请求成功返回：

{
    "trace_id": "796b546bfcc44252bf37480e2c15328f",
    "status": 0,
    "message": "OK",
    "data": {}
}

5.错误码：

status 说明
400 错误请求，参数有误
500 未知的服务内部错误（无法拿到明确message，可联系平台研发排查问题）
4000 业务内部错误（能拿到明确message）
4002 签名校验错误
文章目录