美文网首页
新闻、快讯接口

新闻、快讯接口

作者: 狻猊_c49a | 来源:发表于2018-10-29 15:46 被阅读0次

    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 反馈信息

    相关文章

      网友评论

          本文标题:新闻、快讯接口

          本文链接:https://www.haomeiwen.com/subject/euidtqtx.html