ShuRenZhiDaoWEBAPI
5.92 KB
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
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
0.其他
0.1 所有接口返回格式{"state":1,"data":"jsonarray or jsonobject"} , state 1成功 0失败
0.2 下面所有需要分页的接口都会增加如下参数: index:第几页,从0开始 size:每页大小
1.首页
1.1 频道分类
1.1.1 获取频道接口
权限:全部
参数:无
返回:我的频道列表和推荐频道列表,频道数据包括频道名字和频道ID。未登录时我的频道列表为空。
1.1.2 设置我的频道接口
权限:登录用户
参数:频道ID列表
返回:是否设置成功
1.2 首页新闻
1.2.0 新闻列表数据格式(暂定)
文章ID:
文章类型:普通文章还是广告文章
预览图:列表里显示的小图
封面图:用于滚动显示的大图(没有可以不返回)
新闻标题:
浏览点击量:
发布时间:时间戳,单位秒
文章地址:这个可以直接给地址,也可以我们自己拼,你看吧。
1.2.1 新闻列表接口
权限:全部
参数:频道id , 需分页
返回:返回该频道下的全部新闻,格式见1.2.0
1.2.2 轮播新闻列表
权限:全部
参数:无
返回:全部的轮播新闻,格式见1.2.0
1.2.3 关于随机广告
如果新闻列表接口服务端已经随机加入广告了,那就不用广告列表接口了。如果要APP随机加,那就增加个返回全部广告文章的接口。
2、我的班级
2.1、首页帖子列表
权限:登录用户
参数:分页
返回:帖子信息列表
2.1.1、帖子信息列表数据格式(暂定)
data:[
{
id(Integer):唯一标识
title(String):标题,
type(String):帖子类型
content(String):内容,
chatCount(Integer):回帖数(评论数),
praiseCount(String):点赞数,
userId(integer):发帖人身份id,
userImg(String):发帖人头像url,
userName(String):发帖人昵称
time(Integer):帖子发布时间戳
},...,
{...}
]
2.2、加入班级圈
权限:登录用户(家长、教师身份)
参数:学校id、班级id、身份类型、姓名(昵称)
返回:是否加入成功
2.3、任课任职申请
权限:教师身份的登录用户
参数:学校id、班级id、职位编号、验证者的信息{id、身份类型}
返回:递交申请是否成功
2.4、获取验证者信息列表
权限:教师身份的登录用户
参数:学校id、班级id
返回:验证者信息
2.4.1、验者信息列表数据格式
data:[
{
userId:用户id
userName:用户昵称
worker:职称
userImg:用户头像url
}
]
2.5、认证教师
权限:登录用户
参数:无
返回:待认证的用户
2.5.1、待认证用户数据格式
data:[
{
userId:认证用户id,
userName:认证用户的昵称
authId:认证用户任职的职务id
authName:认证用户任职的职务
}
]
2.6、发布帖子
权限:登录用户(家长、教师身份)
参数:用户身份类型、用户昵称、帖子标题、帖子类型、帖子内容、附件(图片)信息:{图片url}
返回:是否发帖成功
2.7、评论帖子
权限:登录用户
参数:帖子id、评论的内容
返回:是否评论成功
2.8、帖子点赞
权限:登录用户
参数:帖子id
返回:是否点赞成功
2.9、返回评论列表
权限:登录用户
参数:帖子id,分页
返回:帖子评论列表
2.9.1、评论列表数据格式
comment(Array):[{
userId(integer):评论者身份id,
userImg(String):评论者头像url,
userName(String):评论者昵称,
time(Integer):评论发布的时间戳,
content(String):评论内容
}]
3.直播大厅:
3.1 年段分类
3.1.1 获取年段分类列表接口
权限:全部
参数:无
返回:年段ID,名字
3.2 年级分类
3.2.1 根据年段返回年级列表接口
权限:全部
参数:年段ID
返回:年级ID,名字,图标url
3.2.2 根据年级返回直播列表接口
权限:全部
参数:年级ID
返回:直播列表
3.3 最热直播列表
3.3.1 最热直播首页和更多分页接口
权限:全部
参数:index:第几页,从0开始 size:每页大小
返回:最热直播列表
3.4 直播数据格式
3.4.1 数据格式
直播ID
直播创建人
创建人ID
创建人名字
创建人职称
直播名字
直播封面
直播地址
直播价格:10元
直播已购买人数:已有***人购买
直播时间:2017/02/15 09:00 - 2017/02/15 12:00
课程介绍
授课老师介绍
课程评价
直播间观看人数
直播类型:最热
直播年级分类:小学一年级,高中三年级
直播科目分类:语文,数学
3.4.2 在线购买接口:用来记录多少人购买
权限:登录用户
参数:无
返回:是否记录成功
4.个人中心
4.1注册
4.1.1注册接口
权限:全部
参数:手机号,密码,昵称,头像,验证码(获取如:4.1.2)
返回:是否注册成功
4.1.2手机验证码获取接口
权限:全部
参数:手机号
返回:验证码
4.2登录接口
权限:全部
参数:手机号,密码
返回:用户id,任教班级,头像,昵称,手机号码
4.3重新设置密码接口
权限:全部
参数:手机号,新密码,验证码(获取如:4.1.2)
返回:是否修改成功
4.4好评支持
4.4.1好评列表接口
权限:全部
参数:无
返回:评论列表(评论发表时间,内容,发表人昵称,头像和id)
4.4.2发表好评接口
权限:当前登录账号
参数:评论发表时间,内容,发表人昵称,头像和id
返回:是否发表成功
4.5我的钱包接口
权限:当前登录账号
参数:分页
返回:交易记录列表
4.6我的课程接口
权限:当前登录账号
参数:无
返回:已购买的课程列表