盲盒 | 后端API接口文档

# 盲盒

# 抽奖

/v2/activities/lottery/capsule/draw POST JSON

参数名	参数类型	参数描述	必选
capsuleType	1 \| 2 \| 3	第一阶段，第二阶段，第三阶段	是
num	number	抽取个数（填3）	是

返回结构：

{
    "ret": 0,
    "errCode": 0,
    "errcode": 0,
    "msg": "success",
    "data": [
        {
            "_id": "694219041ecb19148c39889b",
            "type": 1,
            "userId": 50157,
            "createTime": "2025-12-17T02:44:20.601Z",
            "data": {
                "name": "锦鲤",
                "imgUrl": "https://freelog-image.oss-cn-shenzhen.aliyuncs.com/%E4%B8%89%E8%BD%AE%E7%9B%B2%E7%9B%92%E7%B4%A0%E6%9D%90/%E7%AC%AC%E4%B8%89%E8%BD%AE%E7%9B%B2%E7%9B%92/%E9%94%A6%E9%B2%A4.png",
                "capsuleType": 3
            },
            "__v": 0
        },
        {
            "_id": "694219041ecb19148c39889c",
            "type": 1,
            "userId": 50157,
            "createTime": "2025-12-17T02:44:20.601Z",
            "data": {
                "name": "祥云",
                "imgUrl": "https://freelog-image.oss-cn-shenzhen.aliyuncs.com/%E4%B8%89%E8%BD%AE%E7%9B%B2%E7%9B%92%E7%B4%A0%E6%9D%90/%E7%AC%AC%E4%B8%89%E8%BD%AE%E7%9B%B2%E7%9B%92/%E7%A5%A5%E4%BA%91.png",
                "capsuleType": 3
            },
            "__v": 0
        },
        {
            "_id": "694219041ecb19148c39889d",
            "type": 1,
            "userId": 50157,
            "createTime": "2025-12-17T02:44:20.601Z",
            "data": {
                "name": "孔明灯",
                "imgUrl": "https://freelog-image.oss-cn-shenzhen.aliyuncs.com/%E4%B8%89%E8%BD%AE%E7%9B%B2%E7%9B%92%E7%B4%A0%E6%9D%90/%E7%AC%AC%E4%B8%89%E8%BD%AE%E7%9B%B2%E7%9B%92/%E5%AD%94%E6%98%8E%E7%81%AF.png",
                "capsuleType": 3
            },
            "__v": 0
        }
    ]
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

结构参数：

参数名	参数类型	参数描述
data.name	string	盲盒名称
data.imgUrl	string	盲盒封面地址
data.capsuleType	1 \| 2 \| 3	第一阶段，第二阶段，第三阶段

# 详情

/v2/activities/lottery/capsule/getInfo GET QUERY

参数名	参数类型	参数描述	必选
capsuleType	1 \| 2 \| 3	第一阶段，第二阶段，第三阶段	是

返回结构：

{
    "ret": 0,
    "errCode": 0,
    "errcode": 0,
    "msg": "success",
    "data": [
        {
            "_id": "694219041ecb19148c39889b",
            "type": 1,
            "userId": 50157,
            "createTime": "2025-12-17T02:44:20.601Z",
            "data": {
                "name": "锦鲤",
                "imgUrl": "https://freelog-image.oss-cn-shenzhen.aliyuncs.com/%E4%B8%89%E8%BD%AE%E7%9B%B2%E7%9B%92%E7%B4%A0%E6%9D%90/%E7%AC%AC%E4%B8%89%E8%BD%AE%E7%9B%B2%E7%9B%92/%E9%94%A6%E9%B2%A4.png",
                "capsuleType": 3
            },
            "__v": 0
        },
        {
            "_id": "694219041ecb19148c39889c",
            "type": 1,
            "userId": 50157,
            "createTime": "2025-12-17T02:44:20.601Z",
            "data": {
                "name": "祥云",
                "imgUrl": "https://freelog-image.oss-cn-shenzhen.aliyuncs.com/%E4%B8%89%E8%BD%AE%E7%9B%B2%E7%9B%92%E7%B4%A0%E6%9D%90/%E7%AC%AC%E4%B8%89%E8%BD%AE%E7%9B%B2%E7%9B%92/%E7%A5%A5%E4%BA%91.png",
                "capsuleType": 3
            },
            "__v": 0
        },
        {
            "_id": "694219041ecb19148c39889d",
            "type": 1,
            "userId": 50157,
            "createTime": "2025-12-17T02:44:20.601Z",
            "data": {
                "name": "孔明灯",
                "imgUrl": "https://freelog-image.oss-cn-shenzhen.aliyuncs.com/%E4%B8%89%E8%BD%AE%E7%9B%B2%E7%9B%92%E7%B4%A0%E6%9D%90/%E7%AC%AC%E4%B8%89%E8%BD%AE%E7%9B%B2%E7%9B%92/%E5%AD%94%E6%98%8E%E7%81%AF.png",
                "capsuleType": 3
            },
            "__v": 0
        }
    ]
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

结构参数：

参数名	参数类型	参数描述
data.name	string	盲盒名称
data.imgUrl	string	盲盒封面地址
data.capsuleType	1 \| 2 \| 3	第一阶段，第二阶段，第三阶段

# 转盘

# 抽奖

/v2/activities/lottery/resource/draw POST JSON

参数名	参数类型	参数描述	必选
startDate	Date	开始时间	是
limitDate	Date	结束时间	是
num	number	抽奖数量	是
resourceTagName	string	标签	是

返回结构：

{
  "ret": 0,
  "errCode": 0,
  "errcode": 0,
  "msg": "success",
  "data": [
    {
      "_id": "629d717ed984c73a2484a488",
      "resourceId": "625fb93da9e7a8002e409346",
      "resourceUserId": "50060",
      "resourceUsername": "ZhuC",
      "resourceCreateDate": "2022-04-20T07:41:49.438Z",
      "resource": {
        "resourceId": "625fb93da9e7a8002e409346",
        "latestVersion": "0.1.1",
        "subjectType": 1,
        "intro": "",
        "coverImages": [
          "https://image.freelog.com/preview-image/563b1a837eb7484da60c5026e1bf76c80f00b14e.jpg#x=0&y=0&w=600&h=450&width=600&height=450"
        ],
        "tags": [
          "阿萨德",
          "测试6",
          "987987",
          "标签x"
        ],
        "status": 1,
        "resourceName": "ZhuC/testppt",
        "resourceType": "ppt",
        "userId": 50060,
        "username": "ZhuC",
        "resourceVersions": [
          {
            "version": "0.1.0",
            "versionId": "29346f16a05e5f16f15bb0ec70e28c48",
            "createDate": "2022-04-20T07:42:02.525Z"
          },
          {
            "version": "0.1.1",
            "versionId": "e18e2486c2402a05b30e58b7a76fa961",
            "createDate": "2022-04-22T03:26:06.066Z"
          }
        ],
        "baseUpcastResources": [],
        "policies": [
          {
            "policyId": "67b88f266da4973ecf98fb1042ce33f9",
            "policyName": "免费订阅（包月）",
            "status": 1
          }
        ],
        "createDate": "2022-04-20T07:41:49.438Z",
        "updateDate": "2022-05-07T06:55:04.465Z"
      },
      "tag": 1,
      "__v": 0
    },
    {
      "_id": "629d717ed984c73a2484a489",
      "resourceId": "6260f96ea9e7a8002e409607",
      "resourceUserId": "50060",
      "resourceUsername": "ZhuC",
      "resourceCreateDate": "2022-04-21T06:27:58.138Z",
      "resource": {
        "resourceId": "6260f96ea9e7a8002e409607",
        "latestVersion": "0.1.0",
        "subjectType": 1,
        "intro": "",
        "coverImages": [
          "https://image.freelog.com/preview-image/e518b3dd5c040e0e84f293151eaf0b37e0dff8af.jpg#x=0&y=0&w=1600&h=1200&width=1600&height=1200"
        ],
        "tags": [
          "测试6",
          "987987",
          "标签x"
        ],
        "status": 1,
        "resourceName": "ZhuC/testPDF2",
        "resourceType": "pdf",
        "userId": 50060,
        "username": "ZhuC",
        "resourceVersions": [
          {
            "version": "0.1.0",
            "versionId": "39858c98738e43b02fd37dd4615f20fb",
            "createDate": "2022-04-21T06:28:03.981Z"
          }
        ],
        "baseUpcastResources": [],
        "policies": [
          {
            "policyId": "67b88f266da4973ecf98fb1042ce33f9",
            "policyName": "免费订阅（包月）",
            "status": 1
          }
        ],
        "createDate": "2022-04-21T06:27:58.138Z",
        "updateDate": "2022-05-07T06:55:04.465Z"
      },
      "tag": 1,
      "__v": 0
    }
  ]
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104

结构参数：

参数名	参数类型	参数描述
_id	string	_id
resourceId	string	资源ID
resourceUserId	string	资源创作者ID
resourceUsername	string	资源创作者账号
resourceCreateDate	Date	资源创作时间
resource	any	资源本身（抽奖时的资源瞬时数据）
tag	number	审核状态 1：未审核\|审核不通过 2：审核通过

# 列出结果

/v2/activities/lottery/resource/list GET QUERY

参数名	参数类型	参数描述	必选
startDate	Date	开始时间	是
limitDate	Date	结束时间	是
skipSize	number	略过数目	是
pageSize	number	页面大小	是
resourceTagName	string	标签	是

返回结构：

{
  "ret": 0,
  "errCode": 0,
  "errcode": 0,
  "msg": "success",
  "data": {
    "num": 2,
    "lotteryResources": [
      {
        "_id": "629d717ed984c73a2484a488",
        "resourceId": "625fb93da9e7a8002e409346",
        "resourceUserId": "50060",
        "resourceUsername": "ZhuC",
        "resourceCreateDate": "2022-04-20T07:41:49.438Z",
        "resource": {
          "resourceId": "625fb93da9e7a8002e409346",
          "latestVersion": "0.1.1",
          "subjectType": 1,
          "intro": "",
          "coverImages": [
            "https://image.freelog.com/preview-image/563b1a837eb7484da60c5026e1bf76c80f00b14e.jpg#x=0&y=0&w=600&h=450&width=600&height=450"
          ],
          "tags": [
            "阿萨德",
            "测试6",
            "987987",
            "标签x"
          ],
          "status": 1,
          "resourceName": "ZhuC/testppt",
          "resourceType": "ppt",
          "userId": 50060,
          "username": "ZhuC",
          "resourceVersions": [
            {
              "version": "0.1.0",
              "versionId": "29346f16a05e5f16f15bb0ec70e28c48",
              "createDate": "2022-04-20T07:42:02.525Z"
            },
            {
              "version": "0.1.1",
              "versionId": "e18e2486c2402a05b30e58b7a76fa961",
              "createDate": "2022-04-22T03:26:06.066Z"
            }
          ],
          "baseUpcastResources": [],
          "policies": [
            {
              "policyId": "67b88f266da4973ecf98fb1042ce33f9",
              "policyName": "免费订阅（包月）",
              "status": 1
            }
          ],
          "createDate": "2022-04-20T07:41:49.438Z",
          "updateDate": "2022-05-07T06:55:04.465Z"
        },
        "tag": 1,
        "__v": 0
      },
      {
        "_id": "629d717ed984c73a2484a489",
        "resourceId": "6260f96ea9e7a8002e409607",
        "resourceUserId": "50060",
        "resourceUsername": "ZhuC",
        "resourceCreateDate": "2022-04-21T06:27:58.138Z",
        "resource": {
          "resourceId": "6260f96ea9e7a8002e409607",
          "latestVersion": "0.1.0",
          "subjectType": 1,
          "intro": "",
          "coverImages": [
            "https://image.freelog.com/preview-image/e518b3dd5c040e0e84f293151eaf0b37e0dff8af.jpg#x=0&y=0&w=1600&h=1200&width=1600&height=1200"
          ],
          "tags": [
            "测试6",
            "987987",
            "标签x"
          ],
          "status": 1,
          "resourceName": "ZhuC/testPDF2",
          "resourceType": "pdf",
          "userId": 50060,
          "username": "ZhuC",
          "resourceVersions": [
            {
              "version": "0.1.0",
              "versionId": "39858c98738e43b02fd37dd4615f20fb",
              "createDate": "2022-04-21T06:28:03.981Z"
            }
          ],
          "baseUpcastResources": [],
          "policies": [
            {
              "policyId": "67b88f266da4973ecf98fb1042ce33f9",
              "policyName": "免费订阅（包月）",
              "status": 1
            }
          ],
          "createDate": "2022-04-21T06:27:58.138Z",
          "updateDate": "2022-05-07T06:55:04.465Z"
        },
        "tag": 1,
        "__v": 0
      }
    ]
  }
}

结构参数：

参数名	参数类型	参数描述
_id	string	_id
resourceId	string	资源ID
resourceUserId	string	资源创作者ID
resourceUsername	string	资源创作者账号
resourceCreateDate	Date	资源创作时间
resource	any	资源本身（抽奖时的资源瞬时数据）
tag	number	审核状态 1：未审核\|审核不通过 2：审核通过

# 审核

/v2/activities/lottery/resource/updateTag POST JSON

参数名	参数类型	参数描述	必选
ids	string[]	id数组	是
tag	number	审核状态 1：未审核\|审核不通过 2：审核通过	是

# 展示结果

/v2/activities/lottery/resource/show GET QUERY

参数名	参数类型	参数描述	必选
startDate	Date	开始时间	是
limitDate	Date	结束时间	是
resourceTagName	string	标签	是

返回结构：

{
  "ret": 0,
  "errCode": 0,
  "errcode": 0,
  "msg": "success",
  "data": [
    {
      "resourceUsername": "ZhuC"
    },
    {
      "resourceUsername": "ZhuC"
    }
  ]
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14

结构参数：

参数名	参数类型	参数描述resource
resourceUsername	string	资源创作者账号

← 任务系统接口文档_客户端活动专题接口文档 →