后端API接口文档

转盘转（抽奖） /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
      }
    ]
  }
}
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
105
106
107

结构参数：

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

抽奖审核 /v2/activities/lottery/resource/updateTag PUT JSON

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

显示抽奖结果 /v2/activities/ads/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 资源创作者账号

筛选元素 /v2/activities/lottery/elementsSelect POST JSON

参数名 参数类型 参数描述 必选
elements any[] 要筛选的元素集合 是
excludeElements any[] 排除的元素集合 否
num number 筛选数量 是

请求结构：

{
	"elements":[1,2,3],
	"num":2
}
1
2
3
4

返回结构：

{
  "ret": 0,
  "errCode": 0,
  "errcode": 0,
  "msg": "success",
  "data": [
    1,
    3
  ]
}
1
2
3
4
5
6
7
8
9
10

← 公众号接口文档_客户端 →