追加售后消息

API文档最后更新: 2026-08-31

8.3 追加售后消息

  • 请求方式：POST

  • 请求地址：/aftersales/{platformCaseRef}/messages

文本消息：

{
  "clientMessageRef": "ASMSG-20260728-0001",
  "format": "text",
  "body": "补充说明"
}

图片消息：

{
  "clientMessageRef": "ASMSG-20260728-0002",
  "format": "image",
  "body": "https://buyer.example.com/evidence/2.jpg"
}

请求字段：

字段

位置

JSON 类型

必填

含义

platformCaseRef

Path

string

是

要追加消息的平台售后编号

clientMessageRef

Body

string

是

第三方消息编号，在当前售后内唯一；1 至 64 个字符，只能使用字母、数字、短横线和下划线；网络重试必须继续使用原编号

format

Body

string

是

text 文字消息；image 图片地址

body

Body

string

是

文字正文或公网 HTTPS 图片地址，最多 255 个字符

clientMessageRef 由第三方生成，在当前售后单下不能重复；长度为 1 至 64 个字符，只能使用字母、数字、短横线和下划线。网络超时后使用同一个编号重试；编号和消息内容都相同时返回原消息，不会重复追加，编号相同但内容不同时返回 IDEMPOTENCY_CONFLICT。文本和 URL 均不得超过 255 个字符。

成功后返回新增消息。第三方追加的消息会原样返回 clientMessageRef：

{
  "code": 0,
  "message": "success",
  "data": {
    "messageRef": 504,
    "clientMessageRef": "ASMSG-20260728-0001",
    "authorRole": "buyer",
    "format": "text",
    "body": "补充说明",
    "createdAt": 1785217200
  },
  "requestId": "req_01K0EXAMPLE"
}

返回字段：

字段

JSON 类型

必填

含义

code

integer

是

固定为 0，表示请求成功

message

string

是

本次请求的处理说明

data

object

是

本次新增的售后消息

data.messageRef

integer

是

售后消息编号

data.clientMessageRef

string

否

第三方提交的消息编号；第三方追加的消息会返回

data.authorRole

string

是

buyer 第三方采购方发送；merchant 供货商发送

data.format

string

是

text 文字消息；image 公网 HTTPS 图片地址

data.body

string

是

消息正文；图片消息时是公网 HTTPS 图片地址

data.createdAt

integer

是

消息创建时间，10 位 Unix 秒级时间戳

requestId

string

是

本次请求编号，排查问题时提供给平台

本接口已经同步返回第三方刚提交的消息，因此不会再通过 Webhook 把同一条消息推回。商户或平台之后新增的公开回复通过 aftersale.message.created 推送，并同时携带售后当前状态。

上一篇下一篇