Plus (ThinkSNS+)

Plus (ThinkSNS+)

  • 文档 [New]
  • 文档
  • REST API v2
  • 反馈
  • GitHub

›资讯

基本

  • 概述
  • 启动信息
  • Json Web Token 授权
  • 验证码
  • 位置
  • 标签
  • 消息通知
  • 钱包(旧版本)
  • Plus Pay(新钱包-支付工具)
  • 支付能力
  • 文件
  • 关于我们
  • 广告
  • 举报
  • 积分
  • 环信
  • 评论
  • 文件存储

用户

  • 用户
  • 注册
  • 收到的评论
  • 收到的喜欢
  • 关注
  • 标签
  • 身份认证
  • 找人
  • 排行榜
  • 反馈
  • 打赏用户
  • 未读消息
  • 签到
  • 消息

动态

  • 发布动态
  • 获取动态
  • 删除动态
  • 设置评论收费
  • 评论
  • 喜欢
  • 收藏
  • 置顶
  • 打赏
  • 排行榜
  • 举报
  • 积分部分新增接口
  • 话题

音乐

  • 音乐
  • 专辑
  • 点赞
  • 评论
  • 收藏

问答

  • 概述
  • 话题
  • 问题
  • 评论
  • 回答
  • 回答 · 打赏
  • 回答 · 围观
  • 用户 · 关注问题
  • 用户 · 喜欢回答
  • 用户 · 收藏回答
  • 用户 · 申请精选
  • 排行榜
  • 举报
  • 问答部分积分相关新增接口

资讯

  • 概述
  • 分类
  • 投稿
  • 获取
  • 评论
  • 喜欢
  • 打赏
  • 置顶
  • 收藏
  • 排行榜
  • 举报
  • 资讯部分积分相关新增接口

圈子

  • 概述
  • 分类
  • 圈子
  • 圈子 · 管理
  • 圈子 · 举报
  • 圈子 · 成员
  • 帖子
  • 帖子 · 评论
  • 帖子 · 喜欢
  • 帖子 · 收藏
  • 帖子 · 打赏
  • 帖子 · 置顶
  • 圈子部分积分相关新增接口
Edit

获取

  • 获取资讯列表
  • 获取置顶资讯列表
  • 获取资讯详情
  • 获取一条资讯的相关资讯

获取资讯列表

GET /news

传入参数

名称说明
limit数据返回条数 默认为20
after数据翻页标识
key搜索关键字
cate_id分类id
recommend推荐筛选 =1为筛选推荐资讯列表
id需要按照 ID 获取的资讯 ID,多个使用半角 , 进行分割

Response

Status: 200 OK
[
    {
        "id": 2,
        "title": "asdasdasdad",
        "subject": "阿拉拉啊拉",
        "created_at": "2017-08-02 03:28:38",
        "updated_at": "2017-08-02 09:08:51",
        "from": "原创",
        "author": "root",
        "user_id": 1,
        "hits": 10,
        "has_collect": false,
        "has_like": false,
        "category": {
            "id": 1,
            "name": "1121",
            "rank": 0
        },
        "image": {
            "id": 2,
            "size": "370x370"
        }
    },
    {
        "id": 1,
        "title": "123",
        "subject": "0",
        "created_at": "2017-07-31 11:56:32",
        "updated_at": "2017-07-31 06:31:31",
        "from": "原创",
        "author": "root",
        "user_id": 1,
        "hits": 5,
        "has_collect": false,
        "has_like": false,
        "category": {
            "id": 1,
            "name": "1121",
            "rank": 0
        },
        "image": {
            "id": 1,
            "size": "100x100"
        }
    }
]

返回参数

名称类型说明
idint数据id
titlestring资讯标题
subjectstring副标题
fromstring来源
authorstring作者
user_idint发布者id
hitsint点击数
has_collectbool当前用户是否已收藏
has_likebool当前用户是否已点赞
categoryarray所属分类信息
category.idint所属分类id
category.namestring所属分类名称
category.rankint所属分类排序
imagearray/null资讯封面信息 为null时表示该资讯无缩略图
image.idint资讯封面附件id
image.sizestring资讯封面尺寸

获取置顶资讯列表

GET /news/categories/pinneds

传入参数

名称说明
cate_id分类id

Response

Status: 200 OK

返回数据体 同资讯列表

获取资讯详情

GET /news/{news}

Response

Status: 200 OK
{
    "id": 2,
    "created_at": "2017-08-02 03:28:38",
    "updated_at": "2017-08-02 09:08:51",
    "title": "asdasdasdad",
    "content": "@![辣鸡啊](3) adasd image @![辣鸡啊](4)",
    "digg_count": 0,
    "comment_count": 0,
    "hits": 4,
    "from": "原创",
    "is_recommend": 0,
    "subject": "阿拉拉啊拉",
    "author": "root",
    "audit_status": 0,
    "audit_count": 0,
    "user_id": 1,
    "contribute_amount": 100,
    "has_collect": false,
    "has_like": false,
    "is_pinned": false,
    "category": {
        "id": 1,
        "name": "1121",
        "rank": 0
    },
    "image": {
        "id": 2,
        "size": "370x370"
    },
    "tags": [
        {
            "id": 2,
            "name": "标签2",
            "tag_category_id": 1
        },
        {
            "id": 1,
            "name": "标签1",
            "tag_category_id": 1
        }
    ]
}

返回参数

名称类型说明
idint资讯id
titlestring标题
contenttext资讯内容 markdown格式 含自定义标签()
digg_countint点赞数
comment_countint评论数
hitsint点击量
fromstring来源
is_recommendint是否为推荐
subjectstring副标题
authorstring作者
audit_statusint审核状态
0-正常
1-待审核
2-草稿
3-驳回
4-删除
5-退款中
audit_countint审核驳回次数
user_idint发布者id
contribute_amountint投稿金额
has_collectbool当前用户是否已收藏
has_likebool当前用户是否已点赞
is_pinnedbool是否已置顶 1-已置顶
categoryarray所属分类信息
category.idint所属分类id
category.namestring所属分类名称
category.rankint所属分类排序
imagearray资讯封面信息
image.idint资讯封面附件id
image.sizestring资讯封面尺寸
tagsarray标签列表
tags.idint标签id
tags.namestring标签名称
tags.tag_category_idint标签分类id

获取一条资讯的相关资讯

GET /news/{news}/correlations

可选参数

名称类型必填说明
limitint-返回关联数据条数

Response

Status: 200 OK
[
    {
        "id": 4,
        "title": "标题",
        "subject": "llaa",
        "created_at": "2017-08-07 09:31:00",
        "updated_at": "2017-08-08 06:41:51",
        "from": "原创",
        "author": "root",
        "user_id": 1,
        "hits": 34,
        "has_collect": false,
        "has_like": false,
        "category": {
            "id": 1,
            "name": "1121",
            "rank": 0
        },
        "image": {
            "id": 2,
            "size": "370x370"
        }
    },
    {
        "id": 1,
        "title": "123",
        "subject": "0",
        "created_at": "2017-07-31 11:56:32",
        "updated_at": "2017-08-08 01:58:07",
        "from": "222",
        "author": "111",
        "user_id": 1,
        "hits": 3,
        "has_collect": false,
        "has_like": false,
        "category": {
            "id": 1,
            "name": "1121",
            "rank": 0
        },
        "image": {
            "id": 1,
            "size": "100x100"
        }
    },
    {
        "id": 2,
        "title": "asdasdasdad",
        "subject": "阿拉拉啊拉",
        "created_at": "2017-08-02 03:28:38",
        "updated_at": "2017-08-03 07:53:34",
        "from": "原创",
        "author": "root",
        "user_id": 1,
        "hits": 5,
        "has_collect": false,
        "has_like": false,
        "category": {
            "id": 1,
            "name": "1121",
            "rank": 0
        },
        "image": {
            "id": 2,
            "size": "370x370"
        }
    }
]

返回参数

同获取资讯列表

← 投稿评论 →
  • 获取资讯列表
    • 传入参数
    • 返回参数
  • 获取置顶资讯列表
    • 传入参数
    • Response
  • 获取资讯详情
    • Response
    • 返回参数
  • 获取一条资讯的相关资讯
    • 可选参数
    • Response
    • 返回参数
Plus (ThinkSNS+)
More
GitHubStar
Copyright © 2019 Chengdu ZhiYiChuangXiang Technology Co., Ltd. All rights reserved.