给指定活动发送评论

接口

发送评论

POST /api/user/activity/:id/comment

授权

如果账号做了 网站授权登录 定制,需要授权登录完成后在发送评论时标明用户身份,否则将使用匿名身份发送评论。

标明身份的方式有两种:

  • 为每个访客在 cookie 中生成的唯一标识(par.shangzhibo.sid)

  • 无法使用 cookie(par.shangzhibo.sid) 时,可以将访客唯一标识通过 URL 后加参数带过来。http://{定制域名}/api/user/activity/:activityId?parSid=xxxxx

无需授权

参数

参数

参数类型

参数说明

是否必填

content

string

评论内容

请求样例

{
  "content": "hello world",
}

响应

参数

参数类型

参数说明

id

integer

评论 ID

status

enum

评论状态,取值:pending 待审核、 passed已通过、failed禁用

content

string

评论内容

createdAt

string

创建时间

updatedAt

string

更新时间

activityId

string

活动 ID

user

object

用户信息

用户信息

参数

参数类型

参数说明

role

enum

角色,取值:agent 管理员、 user登录用户、anonymous匿名用户

nickname

string

用户名

avatar

string

用户头像

响应样例

{
  "id": 42,
  "user": {
    "role": "agent",
    "nickname": "stringValue",
    "avatar": "stringValue"
  },
  "activityId": "stringValue",
  "status": "pending",
  "content": "stringValue",
  "createdAt": "stringValue",
  "updatedAt": "stringValue"
}

最后更新于