• 快站
  • 云评论
帮助中心
topic/load:获取页面评论信息接口

描述

页面首次加载调用,用于生成文章并返回首页评论列表

URL

http://changyan.sohu.com/api/2/topic/load

请求方式

GET

是否需要登录

请求参数

参数名 类型 是否必须 说明
client_id String Y 分配的云评论appid。点击此处查看
topic_url String Y 文章的URL,如果topic_source_id为空,则为文章唯一标识。同时作为审核后台,链接到原文章页面的URL地址
topic_title String N 文章的标题,同时作为审核后台链接到原文章页面的锚点
topic_source_id String N 文章在本网站的id。如不为空,则为文章唯一标识,即相同的topic_source_id 返回的评论列表相同
topic_category_id String N 文章分类/频道
page_size int N 首页展示最新列表的条数,默认0
hot_size int N 最热列表展示条数,默认0
callback String N 如果callback为空,则返回JSON格式。如果不为空,则为JSONP格式,callback为回调函数名字

返回格式

JSON/JSONP

返回参数

字段名 类型 说明
topic_id long 文章在云评论中的唯一标识
cmt_sum int 文章的评论总数(包括对评论的回复)
outer_cmt_sum int 文章的直接评论数(评论翻页时使用)
total_page_no int 总页数
comments Json评论数组 评论列表
comments[*].passport Json对象 评论作者信息

代码示例

{
    "mode": 0, //审核模式
    "comments": [ //最新评论列表
        {
            "content": "分享图片", //评论内容
            "from": "", //来源
            "status": 0, //状态 0=正常 1=删除
            "passport": { //评论用户信息
                "nickname": "满城灯火70", //用户昵称
                "from": "",
                "expired": false,
                "grant": false,
                "passport_id": null,
                "user_id": 53188416, //用户id
                "platform_id": 0,
                "img_url": "", //头像地址
                "followers_count": 0,
                "profile_url": "http://changyan.sohu.com/c/2312039", //个人主页
                "is_shared": false
            },
            "attachments": [ //发表图片
                {
                    "type": 1,
                    "url": "http://img.itc.cn/comment/odffLdL_png", //图片地址
                    "description": null
                }
            ],
            "top": false, //是否置顶
            "elite": false, //是否加精
            "medal": { //勋章信息
                "exp": 1,
                "rank": {
                    "code": "1",
                    "name": "等级1",
                    "medalName": "跟帖菜鸟"
                }
            },
            "comments": [], //盖楼列表
            "hide": false, //是否隐藏当前评论
            "highlight": false, //是否高亮评论
            "create_time": 1375340783000, //发表时间
            "comment_id": 2312039, //评论id
            "user_id": 53188416, //用户id
            "support_count": 0, //顶数
            "oppose_count": 0, //参数
            "reply_count": 0, //回复数
            "ip_location": "北京市", //地域信息
            "hide_floor": false //是否隐藏重复盖楼
        }
    ],
    "hots": [ //最热评论列表
        {
            "content": "ffsfsd",
            "from": "",
            "status": 0,
            "passport": {
                "nickname": "云评论网友",
                "from": "",
                "expired": false,
                "grant": false,
                "passport_id": null,
                "user_id": 0,
                "platform_id": 0,
                "img_url": "",
                "followers_count": 0,
                "profile_url": null,
                "is_shared": false
            },
            "attachments": [],
            "top": false,
            "elite": false,
            "medal": null,
            "hide": false,
            "highlight": false,
            "create_time": 1366944905000,
            "comment_id": 22429,
            "user_id": 2000000997,
            "support_count": 2,
            "oppose_count": 0,
            "reply_count": 0,
            "ip_location": "北京市",
            "hide_floor": false
        }
    ],
    "topic_id": 5172, //评论id
    "cmt_sum": 389, //评论总数
    "outer_cmt_sum": 389, //列表长度,用于计算分页,推荐用total_page_no
    "participation_sum": 467, //参与数
    "like_sum": 1, //喜欢数
    "share_sum": 3, //分享数
    “total_page_no”: 33 //总页数
}