文档
测试

大众浏览-投票列表

GET
http://zqh.5rkk.com/activity/api/v1/votes

接口描述

第一次点击“所有作品(投票)”,只传aid参数。“我的” category传0或不传值。“优秀作品”同样读取program数据,详情看示例。只有tt_type为3时,返回category分类列表。

请求头

参数名
类型
描述
必填
Authorization
string
Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhcHBpZCI6MSwiZGV2aWNlX2lkIjoibHVrZSIsImV4cCI6MTY0NDg5MzYwMCwiaXNzIjoiOXA2eWp1b2FWeG4wVnd3bVN0dEljbTNYSndtY2ZSQ2siLCJwbGF0Zm9ybSI6InBjIiwic2l0ZSI6NiwidWlkIjoiNWM1NTIwMGMtYjg0Yi0xMWVhLWE1ZTMtZGNmNDAxZTcyNTAwIn0.emDhpITn1YTuBG6V8_I3qwq2rSY2D4DV_X3QpFDFecQ
可选
User-Id
string
5c55200c-b84b-11ea-a5e3-dcf401e72500
可选

请求参数

参数名
类型
描述
必填
aid
int
活动id
必填
keyword
string
搜索内容
可选
tt_type
int
顶部分类id
可选
category
int
作品分类id
可选
sort
int
排序分类id
可选

响应参数

参数名
类型
描述
必填
code
int
状态码 0:成功
必填
msg
string
示例:请求成功
必填
data
array
返回数据
必填
awards
array
优秀作品列表
必填
program
array
作品列表
必填
id
int
作品编号id
必填
uid
string
用户id
必填
aid
int
活动id
必填
cid
int
作品分类id
必填
title
string
作品标题
必填
pro
string
讲解内容
必填
type
int
类型 1:图片 2:视频
必填
imgs
string
图片路径json
必填
video
string
视频路径
必填
is_select
int
精选 0:否 1:是
必填
zan
int
投票量(人气)
必填
statue
int
状态 -1:草稿/未提交 0:审核中 1:已发布 2:未通过
必填
created_at
string
创建时间
必填
updated_at
string
修改时间
必填
deleted_at
object
必填
head
string
头像
必填
nickname
string
姓名
必填
category
string
作品分类名称
必填
activity
array
活动信息
必填
id
int
活动id
必填
vote_start
string
投票评选开始时间
必填
vote_end
string
投票评选结束时间
必填
vote_name
string
投票按钮文案
必填
vote_time
int
投票时间 1:整个评选阶段 2:每天
必填
vote_pnum
int
每人可投票作品数量
必填
vote_num
int
每个作品可投票数量
必填
award_switch
int
颁奖设置开关 0:关 1:开
必填
statue
int
状态 -1:草稿/未提交 0:审核中 1:已发布 2:审核失败 3:审核成功/已通过
必填
vote_type
string
投票状态文本
必填
award_remark
string
优秀作品公布说明
必填
tt_type
array
顶部分类信息
必填
id
int
分类id
必填
title
string
分类内容
必填
category
array
作品分类信息
可选
id
int
分类id
必填
aid
int
活动id
必填
title
string
分类内容
必填
sort
array
排序信息
必填
id
int
排序id
必填
title
string
排序内容
必填
param
array
所传参数值或参数默认值
必填
aid
int
活动id
必填
keyword
string
搜索内容
可选
tt_type
int
顶部分类id
可选
category
int
作品分类id
可选
sort
int
排序分类id
可选
page
int
当前页
必填
page_num
int
每页数据条数
必填
total
int
总页数
必填

说明 / 示例

``` { "code": 0, "msg": "请求成功", "data": { "awards": [], "program": [ { "id": 5, "uid": "5c55200c-b84b-11ea-a5e3-dcf401e72500", "aid": 1, "cid": 10, "title": "我的最nice作品", "pro": "最棒的一次创作", "type": 1, "imgs": "https://p.cyol.com/1.jpg", "video": "1.mp4", "is_select": 0, "zan": 0, "statue": 1, "created_at": "2021-11-29 13:38:21", "updated_at": "2021-12-01 14:53:31", "deleted_at": null, "head": "3.jpg", "nickname": "" } ], "activity": { "id": 1, "vote_start": "2021-11-30 13:54:38", "vote_end": "2021-12-30 13:54:38", "vote_name": "点赞", "vote_time": 1, "vote_pnum": 1, "vote_num": 2, "award_switch": 1, "award_remark": "这是优秀作品集合展示", "is_award": 0, "statue": 1, "vote_type": "进行中" }, "tt_type": [ { "id": 1, "title": "我的" }, { "id": 2, "title": "精选" }, { "id": 3, "title": "全部" }, { "id": 4, "title": "优秀作品" } ], "category": [ { "id": 0, "aid": 1, "title": "全部" }, { "id": 8, "aid": 1, "title": "教育2333" }, { "id": 10, "aid": 1, "title": "教育2333" }, { "id": 13, "aid": 1, "title": "教育2333" }, { "id": 15, "aid": 1, "title": "教育2333" }, { "id": 9, "aid": 1, "title": "娱乐2333" }, { "id": 11, "aid": 1, "title": "娱乐2333" }, { "id": 12, "aid": 1, "title": "娱乐2" }, { "id": 14, "aid": 1, "title": "娱乐2333" }, { "id": 16, "aid": 1, "title": "娱乐2333" } ], "sort": [ { "id": 1, "title": "人气" }, { "id": 2, "title": "最新" }, { "id": 3, "title": "最早" } ], "param": { "aid": 1, "keyword": "", "tt_type": 3, "category": 0, "sort": 1, "page": 3, "page_num": 1, "total": 3 } } } 优秀作品返回数据 { "code": 0, "msg": "请求成功", "data": { "awards": [ { "data": [ { "id": 1, "uid": "5c55200c-b84b-11ea-a5e3-dcf401e72500", "aid": 1, "cid": 8, "title": "123", "pro": "123123123", "type": 1, "imgs": "https://p.cyol.com/1.jpg", "video": "123123123.mp4", "is_select": 1, "zan": 3, "statue": 1, "created_at": "2021-11-16 14:59:32", "updated_at": "2021-12-01 14:43:35", "deleted_at": null, "category": "教育2333", "pid": 1, "nickname": null } ], "title": "一等奖", "num": 1, "pro": "最好的" }, { "data": [], "title": "二等奖", "num": 5, "pro": "一般好的" }, { "data": [], "title": "三等奖", "num": 15, "pro": "优秀的" } ], "program": [], "activity": { "id": 1, "vote_start": "2021-11-30 13:54:38", "vote_end": "2021-12-30 13:54:38", "vote_name": "点赞", "vote_time": 1, "vote_pnum": 1, "vote_num": 2, "award_switch": 1, "award_remark": "这是优秀作品集合展示", "is_award": 0, "statue": 1, "vote_type": "进行中" }, "tt_type": [ { "id": 1, "title": "我的" }, { "id": 2, "title": "精选" }, { "id": 3, "title": "全部" }, { "id": 4, "title": "优秀作品" } ], "category": [], "sort": [ { "id": 1, "title": "人气" }, { "id": 2, "title": "最新" }, { "id": 3, "title": "最早" } ], "param": { "aid": 1, "keyword": "", "tt_type": 4, "category": 0, "sort": 1, "page": 1, "page_num": 1, "total": 1 } } } ```