腾讯乐享接口文档

# 评论

# 新增一级评论

事件类型：comment/add

目前实体类型 target_type 包含：

  • 文档 doc
  • 课堂clazz
  • 活动event
  • 投票survey
  • 乐问回答 answer

# 文档回调示例

{
	"nonce": "60e451f4-b0f6-4722-9cea-e974c5cee56c",
	"timestamp": 1672024847,
	"sign": "4c9a196d083adbc8fa01a78dc085f501ced47ea8",
	"action": "comment/add",
	"attributes": {
		"target_type": "doc",
		"target_id": "22ac658c84cb11edad196ae9b23b2482",
		"comment_id": "49acde2284cc11edb3396ae9b23b2482",
		"content": "文档一级评论@StaffID1  @StaffID2  \n文档一级评论",
		"at_staffs": [{
			"staff_id": "StaffID1",
			"name": "StaffID1"
		}, {
			"staff_id": "StaffID2",
			"name": "StaffID2"
		}]
	},
	"operator": "StaffID1",
	"operator_info": {
		"name": "StaffID1"
	}
}
# 参数说明：
参数 说明
nonce 用户触发的事件临时码
timestamp 用户触发的事件时间戳
sign 用户触发的事件签名
action 用户触发的事件行为类型
attributes.target_id 产生评论的实体id
attributes.comment_id 当前评论的乐享实体id
attributes.content 评论内容
attributes.at_staffs 被@的用户对象数组
attributes.operator 触发者StaffID
attributes.operator_info.name 触发者姓名

# 乐问回答回调示例

{
	"nonce": "57805c2b-96e9-4c8a-8a96-0e10aedb1cba",
	"timestamp": 1672048648,
	"sign": "335bcb35abdd7cea788d2fe9268ae40fa14f7032",
	"action": "comment/add",
	"attributes": {
		"target_type": "answer",
		"target_id": "7362deec850311ed8976fa4781e2bc14",
		"comment_id": "b4510834850311eda3e0fa4781e2bc14",
		"content": "一级评论<a href=\"\/staffs\/1356fa90916711e88dfe5254009b5a66\" target=\"_blank\" rel=\"noreferrer noopener\">@mistcheng<\/a>  <a href=\"\/staffs\/e3d36c06aa5611ecba38ae18c0260a0b\" target=\"_blank\" rel=\"noreferrer noopener\">@v_adandxu<\/a>  <br \/>乐问一级评论",
		"at_staffs": [{
			"staff_id": "StaffID1",
			"name": "StaffID1"
		}, {
			"staff_id": "StaffID2",
			"name": "StaffID2"
		}],
		"question_id": "964d6b16849f11ed9af1c2c568233c9c"
	},
	"operator": "StaffID1",
	"operator_info": {
		"name": "StaffID1"
	}
}
# 数说明：
参数 说明
attributes.question_id 当前评论所在的乐问id

# 新增二级评论

事件类型：comment/reply

对一级评论回复产生的操作，目前实体类型 target_type 包含：

  • 文档 doc
  • 乐问回答 answer
  • 课堂clazz
  • 活动event
  • 投票survey

# 文档回调示例

{
	"nonce": "2215e455-7a2d-4bd0-a6e5-4811ce73ba07",
	"timestamp": 1672037953,
	"sign": "66bd36ffc2c735dcb4c11c4376c85d1c3c6d3fa1",
	"action": "comment/reply",
	"attributes": {
		"target_type": "doc",
		"target_id": "22ac658c84cb11edad196ae9b23b2482",
		"reply_comment_id": "49acde2284cc11edb3396ae9b23b2482",
		"comment_id": "cce0bfca84ea11edb4dc3e1531dda310",
		"content": "二级评论@StaffID1  @StaffID2  \n二级评论",
		"at_staffs": [{
			"staff_id": "StaffID1",
			"name": "StaffID1"
		}, {
			"staff_id": "StaffID2",
			"name": "StaffID2"
		}]
	},
	"operator": "StaffID1",
	"operator_info": {
		"name": "StaffID1"
	}
}
# 参数说明：
参数 说明
nonce 用户触发的事件临时码
timestamp 用户触发的事件时间戳
sign 用户触发的事件签名
action 用户触发的事件行为类型
attributes.target_id 产生评论的实体id
attributes.reply_comment_id 被回复的一级评论id
attributes.comment_id 当前评论的乐享实体id
attributes.content 二级评论内容
attributes.at_staffs 被@的用户对象数组
attributes.operator 触发者StaffID
attributes.operator_info.name 触发者姓名

# 乐问回答回调示例

{
	"nonce": "35121d21-faa2-4f41-9ab8-6b88b570d545",
	"timestamp": 1672049183,
	"sign": "641c5d65064166444acb5b59c90b1f206474901c",
	"action": "comment/reply",
	"attributes": {
		"target_type": "answer",
		"target_id": "7362deec850311ed8976fa4781e2bc14",
		"reply_comment_id": "b4510834850311eda3e0fa4781e2bc14",
		"comment_id": "f3374120850411edb212fa4781e2bc14",
		"content": "回复 @StaffID3 ：乐问二级评论@StaffID1   @StaffID2  \n二级评论",
		"at_staffs": [{
			"staff_id": "StaffID1",
			"name": "StaffID1"
		}, {
			"staff_id": "StaffID2",
			"name": "StaffID2"
		}],
		"question_id": "964d6b16849f11ed9af1c2c568233c9c"
	},
	"operator": "StaffID1",
	"operator_info": {
		"name": "StaffID1"
	}
}
# 参数说明：
参数 说明
attributes.question_id 当前评论所在的乐问id

# 新增三级评论

事件类型：comment/to-reply

对二级评论回复产生的操作，目前实体类型 target_type 包含：

  • 文档 doc
  • 课堂clazz
  • 活动event
  • 投票survey

特别说明：乐问回答没有三级评论，对二级评论的回复会整合在二级评论内

# 回调示例

{
	"nonce": "119d88e5-0f47-4de5-884a-d9ce01199c24",
	"timestamp": 1672042775,
	"sign": "b75504c4ac6ad3f67ea3f8b2160d1927af24153a",
	"action": "comment/to-reply",
	"attributes": {
		"target_type": "doc",
		"target_id": "3bbc05a084e411ed92d6ee7a5d072d4c",
		"reply_comment_id": "a24ead8c84f211edb1b8461197fd3bdd",
		"comment_id": "080ef04884f611ed8ea8f2c975de78e9",
		"content": "文档三级评论@StaffID1  @StaffID2  \n三级评论",
		"at_staffs": [{
			"staff_id": "StaffID1",
			"name": "StaffID1"
		}, {
			"staff_id": "StaffID2",
			"name": "StaffID2"
		}]
	},
	"operator": "StaffID1",
	"operator_info": {
		"name": "StaffID1"
	}
}
# 参数说明：
参数 说明
nonce 用户触发的事件临时码
timestamp 用户触发的事件时间戳
sign 用户触发的事件签名
action 用户触发的事件行为类型
attributes.target_id 产生评论的实体id
attributes.reply_comment_id 被回复的二级评论id
attributes.comment_id 当前评论的乐享实体id
attributes.content 三级级评论内容
attributes.at_staffs 被@的用户对象数组
attributes.operator 触发者StaffID
attributes.operator_info.name 触发者姓名

# 删除评论

事件类型：comment/delete

# 回调示例

{
  "nonce": "331eea50-73ab-46d2-a6b3-cb308d9ec897",
  "timestamp": 1540891700,
  "sign": "a2734fa116f51ddca096c06156d2be322415b889",
  "action": "comment/delete",
  "attributes": {
    "comment_id": "df79b9f6dc2511e8baa75254009b5a66"
  },
  "operator": "StaffID1",
  "operator_info":{"name":"StaffID1"}
}
# 参数说明：
参数 说明
nonce 用户触发的事件临时码
timestamp 用户触发的事件时间戳
sign 用户触发的事件签名
action 用户触发的事件行为类型
attributes.comment_id 当前评论的乐享实体id
attributes.operator 触发者StaffID
attributes.operator_info.name 触发者姓名

← 分类 →