获取评论[单条]

  • 接口地址: /api/fresns/comment/detail
  • 请求方式: POST
  • 请求格式: JSON

header 可选参数:

参数名公开模式(是否必传)私有模式(是否必传)
uidNOYES
midNOYES
tokenNOYES

body 参数:

参数名类型是否必传说明
cidStringYES评论 ID
mapIdNumberNO地图服务商编号
longitudeStringNO地图经度(用于计算距离)
latitudeStringNO地图纬度(用于计算距离)

返回结果:

成功

{
    "code": 0,
    "message": "ok",
    "data": {
        "common": {
            "seoInfo": {
                //以评论表 ID 和语言标签在 SEO 数据表查找值,如果找不到则为空。
                //接口请求语言标签为空,则以默认语言查找,如果接口有语言标签参数,则以此查找。
                //无论哪种语言标签,找不到则留空,无默认内容。
                "title": "seo > title",
                "keywords": "seo > keywords",
                "description": "seo > description"
            }
        },
        "detail": {
            // detail 参数,参考评论列表接口 list 参数
            // list 接口地址 /api/fresns/comment/lists
            // content 调用附属表,新增 isMarkdown 参数,删除 brief、commentPreviews、replyTo 三个参数
            // post 参数需要输出,因为获取单个评论,需要附带他的所属帖子信息。
            "content": "comment_appends > content 需要解析内容中的“艾特”、“话题”、“链接”、“表情”四种信息。话题输出时,如果后台设置的是「单 # 号」,但是数据库存的是「双 # 号」,则在输出时,删减结尾 # 号;如果后台设置的是「双 # 号」,但是数据库存的是「单 # 号」,则在输出时,为结尾补充 # 号。",
            "isMarkdown": "comment_appends > is_markdown",
            "editCount": "comment_appends > edit_count", //放在 editTimeFormat 参数下面
        }
    }
}
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

失败

{
    "code": "code_messages > code",
    "message": "code_messages > message"
}
1
2
3
4

开发说明

  • 如果是私有模式,当过期后 members > expired_at,需判断到期后的状态。
    • 配置表 site_private_end 键值为 1 时,该接口不可请求;
    • 键值为 2 时,再判断发表时间,如果 comments > created_at 发表时间大于失效时间 members > expired_at,则不输出;如果发表时间小于失效时间,则代表为失效前的内容,可以输出。