1. 新闻、快讯接口
- 1.1 获取新闻源账号新闻/快讯列表
- 1.2 获取赛事新闻/快讯列表
- 1.3发布新闻
- 1.4删除新闻
- 1.5 获取新闻项详细
- 1.6 用户点赞新闻
- 1.7 用户分享新闻
- 1.8 根据新闻id获取新闻的评论列表
- 1.9 用户评论新闻
- 1.10 用户删除评论
- 1.11 更新新闻
1.1 获取新闻源账号新闻/快讯列表
1.1.1 请求说明
请求方式:GET
请求url:/gateway/facade/v1/news/public/news_type/<int:news_type>/activity_id/<int:activity_id>?page_num
/gateway/facade/v1/news/private/news_type/<int:news_type>/activity_id/<int:activity_id>?page_num
1.1.2 请求参数
字段 |
字段类型 |
字段说明 |
news_type |
int |
新闻类型,1为新闻,2为快讯 |
activity_id |
String |
新闻源id |
token |
string |
token |
page_num |
int |
目标页 |
1.1.3 返回参数与说明 同下
1.2 获取赛事新闻/快讯列表
1.2.1 请求说明
请求方式:GET
请求url :/gateway/facade/v1/news/private/news_type/<int:news_type>/match<int:match_id>?page_num
/gateway/facade/v1/news/public/news_type/<int:news_type>/match/<int:match_id>?page_num
1.2.2 参数说明
字段 |
字段类型 |
字段说明 |
news_type |
int |
新闻类型,1为新闻,2为快讯 |
match_id |
String |
赛事id |
token |
string |
token |
page_num |
int |
目标页 |
1.2.3返回结果
1.2.3.1 新闻返回参数
{
"data": {
"news_list": [
{
"account_avatar": "asdjsalkw",
"account_id": '4',
"account_name": "快链",
"created_time": 1539588028992,
"news_id": 2,
"news_img": null,
"news_title": "token",
"news_type": 1
}
],
"page_num": 1,
"page_size": 20,
"total": 1,
"total_page": 1
},
"err": 0,
"msg": "获取成功"
}
1.2.3.2 快讯返回参数
{
"data": {
"news_list": [
{
"created_time": 1539587938253,
"is_agreed": 1,
"news_context": "区块链保护地球",
"news_id": '1',
"news_title": "地球token",
"news_type": 2,
"num_agree": 50,
"num_comment": 8
}
],
"page_num": 1,
"page_size": 20,
"total": 1,
"total_page": 1
},
"err": 0,
"msg": "获取成功"
}
1.2.4 返回参数
1.2.4.1新闻返回参数
字段 |
字段类型 |
字段说明 |
err |
int |
错误标识,0成功获取,1无数据,2获取失败无数据 |
msg |
String |
反馈信息 |
data.page_num |
int |
列表当前页 |
data.page_size |
int |
每页大小,默认20 |
data.total |
int |
记录总数 |
data.total_page |
int |
总页数,默认1 |
account_avatar |
String |
新闻源头像 |
account_id |
String |
新闻源id |
account_name |
String |
新闻源名称 |
created_time |
int |
新闻发布时间=int(time.time() * 1000) |
news_id |
int |
新闻id |
news_img |
JSON |
新闻图 |
news_title |
String |
新闻标题 |
news_type |
int |
新闻类型,1为新闻,2为快讯 |
1.2.4.2快讯返回参数
字段 |
字段类型 |
字段说明 |
err |
int |
错误标识,0成功获取,1无数据,2获取失败无数据 |
msg |
String |
反馈信息 |
data.page_num |
int |
列表当前页 |
data.page_size |
int |
每页大小,默认20 |
data.total |
int |
记录总数 |
data.total_page |
int |
总页数,默认1 |
is_agreed |
String |
是否点赞,1为已点赞,0为未点赞 |
news_context |
String |
新闻内容 |
account_name |
String |
新闻源名称 |
created_time |
int |
快讯发布时间=int(time.time() * 1000) |
news_id |
int |
新闻id |
news_title |
String |
新闻标题 |
news_type |
int |
新闻类型,1为新闻,2为快讯 |
num_agree |
int |
点赞数 |
num_comment |
int |
评论数 |
1.3发布新闻
1.3.1 请求说明:
请求方式:POST
请求url :/gateway/facade/v1/news/private/news/news_type/<int:news_type>/publish
1.3.2请求参数说明:
字段 |
字段类型 |
字段说明 |
news_type |
int |
新闻类型,1为新闻,2为快讯 |
match_id |
String |
赛事id |
token |
string |
token |
news_title |
String |
新闻标题 |
news_context |
String |
新闻内容 |
news_img |
Json |
新闻图片 |
1.3.3返回参数
{
"err": 0,
"msg": "发布成功"
}
1.3.4返回参数说明:
字段 |
字段类型 |
字段说明 |
err |
int |
错误标识,0发布成功, 1发布失败,空内容, 2发布失败 |
msg |
String |
反馈信息 |
1.4删除新闻
1.4.1 请求说明:
请求方式:GET
请求url :/gateway/facade/v1/news/private/delete/news/<int:news_id>
1.4.2 请求参数说明:
字段 |
字段类型 |
字段说明 |
token |
string |
token |
news_id |
int |
新闻编号 |
1.4.3 返回参数:
{
"err": 0,
"msg": "删除成功"
}
1.4.4 返回参数说明:
字段 |
字段类型 |
字段说明 |
err |
int |
错误标识,0删除获取,1非发布者,删除失败,2删除失败 |
msg |
String |
反馈信息 |
1.5 获取新闻项详细
1.5.1 请求说明:
请求方式:GET
请求url :/gateway/facade/v1/news/private/news/news_item/<int:news_id>
请求url :/gateway/facade/v1/news/public/news/news_item/<int:news_id>
1.5.2 请求参数说明:
字段 |
字段类型 |
字段说明 |
token |
string |
token |
news_id |
int |
新闻编号 |
1.5.3 返回参数:
{
"data": {
"is_agreed": 1,
"news_context": "区块链保护地球",
"news_id": 1,
"news_img": null,
"news_title": "地球token",
"news_type": 2
"account_avatar": "",
"account_id": "",
"account_name": "",
"num_agree": 50,
"num_comment": 8,
"num_share":7
},
"err": 0,
"msg": "获取成功"
}
1.5.4返回参数说明:
字段 |
字段类型 |
字段说明 |
err |
int |
错误标识,0成功获取,1无数据,2获取失败无数据 |
msg |
String |
反馈信息 |
data.is_agreed |
int |
是否点赞,1为已点赞,0为未点赞 |
data.news_id |
int |
新闻id |
data.news_title |
String |
新闻标题 |
data.news_img |
json |
新闻图片 |
data.news_context |
String |
新闻内容 |
data.account_avatar |
json |
新闻源头像 |
data.account_name |
String |
新闻源名称 |
data.account_id |
String |
新闻源账号id |
data.created_time |
int |
快讯发布时间=int(time.time() * 1000) |
data.news_type |
int |
新闻类型,1为新闻,2为快讯 |
data.num_agree |
int |
点赞数 |
data.num_comment |
int |
评论数 |
data.num_share |
int |
分享数 |
1.6 用户点赞新闻
1.6.1 请求说明:
请求方式:GET
请求url :/gateway/facade/v1/news/private/agree/news/<int:news_id>
1.6.2 请求参数说明:
字段 |
字段类型 |
字段说明 |
token |
string |
token |
news_id |
int |
新闻编号 |
1.6.3 返回参数:
{
"data": {
"flag": true,
"get_score": 1,
"total_score": 16
},
"err": 0,
"log": "",
"msg": "点赞成功"
}
1.6.4返回参数说明:
字段 |
字段类型 |
字段说明 |
err |
int |
错误标识,0点赞成功,1点赞成奖励上限,2已点赞,点赞失败,3点赞失败 |
msg |
String |
反馈信息 |
data.get_score |
int |
获得分数 |
data.total_score |
int |
总分,若无获得奖励,为0 |
data.score |
int |
获得积分奖励,若无获得奖励,为0 |
1.7 用户分享新闻
1.7.1 请求说明:
请求方式:GET
请求url :/gateway/facade/v1/news/private/share/news/<int:news_id>
1.7.2 请求参数说明:
字段 |
字段类型 |
字段说明 |
token |
string |
token |
news_id |
int |
新闻编号 |
1.7.3 返回参数:
{
"data": {
"flag": true,
"get_score": 1,
"total_score": 16
},
"err": 0,
"log": "",
"msg": "分享成功"
}
1.7.4返回参数说明:
字段 |
字段类型 |
字段说明 |
err |
int |
错误标识, 0分享成功,1分享成功,奖励上限,2分享失败 |
msg |
String |
反馈信息 |
data.get_score |
int |
获得分数 |
data.total_score |
int |
总分,若无获得奖励,为0 |
data.score |
int |
获得积分奖励,若无获得奖励,为0 |
1.8 根据新闻id获取新闻的评论列表
1.8.1 请求说明:
请求方式:GET
请求url :/gateway/facade/v1/news/public/news/comment/news_item/<int:news_id>?page_num=
1.8.2 请求参数说明:
字段 |
字段类型 |
字段说明 |
token |
string |
token |
page_num |
int |
目标页,默认为1 |
1.8.3 返回参数:
{
"data": {
"conment_list": [
{
"comment_context": "Window10",
"comment_id": 5,
"created_time": 1539770986437,
"p_comment_id": 5,
"user_id": '1'
}
],
"page_num": 1,
"page_size": 20,
"total": 3,
"total_page": 1
},
"err": 2,
"msg": "获取失败"
}
1.8.4返回参数说明:
字段 |
字段类型 |
字段说明 |
err |
int |
错误标识,0成功获取,1无数据,2获取失败无数据 |
msg |
String |
反馈信息 |
data.page_num |
int |
列表当前页 |
data.page_size |
int |
每页大小,默认20 |
data.total_page |
int |
总页数,默认1 |
data.total |
int |
评论总数 |
data.comment_id |
int |
评论id |
data.comment_context |
String |
评论内容 |
data.created_time |
int |
发布时间=int(time.time() * 1000) |
data.p_comment_id |
int |
上级评论id |
data.user_id |
user_id |
评论用户id |
1.9用户评论新闻
1.9.1 请求说明:
请求方式:POST
请求url :/gateway/facade/v1/news/private/news/comment/publish?p_comment_id=
1.9.2 请求参数说明:
字段 |
字段类型 |
字段说明 |
p_comment_id |
int |
上级评论id,可为空 |
news_id |
int |
新闻编号 |
context |
String |
评论内容 |
token |
string |
token |
1.9.3 返回参数:
{
"err": 0,
"msg": "评论成功"
}
1.9.4返回参数说明:
字段 |
字段类型 |
字段说明 |
err |
int |
错误标识,0评论成功,1评论失败,参数不足,2评论失败 |
msg |
String |
反馈信息 |
1.10用户删除评论
1.10.1 请求说明:
请求方式:POST
请求url :/gateway/facade/v1/news/private/news/comment/delete
1.10.2 请求参数说明:
字段 |
字段类型 |
字段说明 |
comment_id |
int |
评论id |
token |
string |
token |
1.10.3 返回参数:
{
"err": 0,
"msg": "删除成功"
}
1.10.4返回参数说明:
字段 |
字段类型 |
字段说明 |
err |
int |
错误标识,0删除成功,1删除失败,参数不足,2删除失败 |
msg |
String |
反馈信息 |
1.11 更新新闻
1.11.1 请求说明:
请求方式:POST
请求url :/gateway/facade/v1/news/private/news/<int:news_id>/news_type/<int:news_type>/update
1.11.2 请求参数说明:
字段 |
字段类型 |
字段说明 |
token |
string |
token |
news_type |
int |
新闻类型,1为新闻,2为快讯 |
news_id |
int |
目标新闻id |
match_id |
String |
比赛编号 |
news_title |
String |
新闻标题 |
news_context |
String |
新闻内容 |
news_img |
JOSN |
新闻图片 |
1.11.3 返回参数:
{
"err": 0,
"msg": "更新成功"
}
1.11.4返回参数说明:
字段 |
字段类型 |
字段说明 |
err |
int |
错误标识,0更新成功, 1更新失败,空内容, 2更新失败 |
msg |
String |
反馈信息 |
网友评论