创建评论

在某审批实例下创建、修改评论或评论回复（不包含审批同意、拒绝、转交等附加的理由或意见）。

错误码

HTTP状态码	错误码	描述	排查建议
400	1390001	param is invalid	参数错误

curl --location --request POST 'https://open.feishu.cn/open-apis/approval/v4/instances/6A123516-FB88-470D-A428-9AF58B71B3C0/comments?user_id_type=open_id' \ --header 'Authorization;' \ --header 'Content-Type: application/json' \ --data-raw '{ "content": "{\"text\":\"来自小程序的评论111我带附件中有extra \",\"files\":[{\"url\":\"xxx\",\"fileSize\":155149,\"title\":\"9a9fedc5cfb01a4a20c715098.png\",\"type\":\"image\",\"extra\":\"\"}]}", "at_info_list": [ { "user_id": "579fd9c4", "name": "张某", "offset": "1" } ], "parent_comment_id": "7081516627711524883", "comment_id": "7081516627711524883", "disable_bot": false, "extra": "{\"a\":\"a\"}" }'

请求参数

Path 参数

instance_id

string

必需

审批实例code（或租户自定义审批实例ID）

示例值:

6A123516-FB88-470D-A428-9AF58B71B3C0

Query 参数

user_id_type

string

可选

用户 ID 类型

示例值:

open_id

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

Body 参数application/json

content

string

可选

评论内容，包含艾特人、附件等示例值："{"text":"来自小程序的评论111我带附件中有extra ","files":[{"url":"xxx","fileSize":155149,"title":"9a9fedc5cfb01a4a20c715098.png","type":"image","extra":""}]}"

at_info_list

array [object {3}]

评论中艾特人信息

可选

user_id

string

可选

被艾特人的ID 示例值："579fd9c4"

name

string

可选

被艾特人的姓名示例值："张某"

offset

string

可选

被艾特人在评论中的位置，从0开始示例值："1"

parent_comment_id

string

可选

父评论ID，如果是回复评论，需要传示例值："7081516627711524883"

comment_id

string

可选

评论ID，如果是编辑、删除一条评论，需要传示例值："7081516627711524883"

disable_bot

boolean

可选

disable_bot=true只同步数据，不触发bot 示例值：false

extra

string

可选

附加字段示例值："{"a":"a"}"

示例

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

comment_id

string

必需

保存成功的comment_id

错误码#

请求参数

返回响应

错误码