AI 助手
扣子 AI 帮助与支持
你好,我是 扣子 文档问答助手 🎉 你在阅读当前文档的过程中,无论对文档概念的解释,还是文档内容方面的疑问,都可以随时向我提问,我会全力为你解答
推荐问题
扣子 3.0 都有什么新特性?
扣子和扣子编程有什么区别?
扣子如何收费?
文档反馈
低代码项目
动态
快速开始
智能体
工作流
应用
资源
发布
模型
多人协作
开发工具
API 参考
SDK 参考
音视频
推广与变现

删除消息评价

删除指定消息的评价。

接口限制

仅会话创建者能删除对应会话中消息的评价。

基础信息

请求方式

DELETE

请求地址

https://api.coze.cn/v1/conversations/:conversation_id/messages/:message_id/feedback

权限

feedback
确保调用该接口使用的访问令牌开通了 feedback 权限,详细信息参考鉴权方式

接口说明

删除指定消息的评价。

请求参数

参数

取值

说明

Authorization

Bearer $Access_Token

用于验证客户端身份的访问令牌。你可以在扣子编程中生成访问令牌,详细信息,参考准备工作

Content-Type

application/json

解释请求正文的方式。

Path

参数

类型

是否必选

示例

说明

conversation_id

String

必选

737363834493434****

Conversation ID,即会话的唯一标识。可以在发起对话接口 Response 中查看 conversation_id 字段。

message_id

String

必选

74076856761178****

待删除评价的消息 ID。你可以通过查看对话消息详情 API 返回的 Response 中查看消息 ID。

  • 此消息必须在 conversation_id 指定的会话中。
  • 仅支持评价以下来源的文本消息:
    • 通过发起对话 API 生成的 type=answer 类型的文本消息。
    • 通过执行对话流 API 返回的文本消息。

返回参数

参数

类型

示例

说明

detail

Object of ResponseDetail

{"logid":"20241210152726467C48D89D6DB2****"}

包含请求的详细日志信息,用于问题排查和技术支持。

code

Long

0

调用状态码。0 表示调用成功,其他值表示调用失败,你可以通过 msg 字段判断详细的错误原因。

msg

String

""

状态信息。API 调用失败时可通过此字段查看详细错误信息。
状态码为 0 时,msg 默认为空。

ResponseDetail

参数

类型

示例

说明

logid

String

20241210152726467C48D89D6DB2****

本次请求的日志 ID。如果遇到异常报错场景,且反复重试仍然报错,可以根据此 logid 及错误码联系扣子团队获取帮助。详细说明可参考获取帮助和技术支持

示例

请求示例

DELETE https://api.coze.cn/v1/conversations/751536489399***/messages/751903981556***/feedback \
--header 'Authorization: Bearer pat_xFWpGsNio4S7sfAzpu02vHCkAdL38VnSsTOIu8CkySdY9Z2xmeM8jjn****' \
--header 'Content-Type: application/json'

返回示例

{
  "code": 0,
  "msg": "",
  "detail": {
    "logid": "20241210191248C8EF76****"
  }
}

错误码

如果成功调用扣子编程的 API,返回信息中 code 字段为 0。如果状态码为其他值,则表示接口调用失败。此时 msg 字段中包含详细错误信息,你可以参考错误码文档查看对应的解决方法。