版本:202506
创建评论
POST/openapi/2025-06/comments
为指定商品添加评论。
请求
- application/json
- 请求体
- 示例
请求体必填
comment object必填
评论
product_idstring必填
评论所属商品的 ID
user_namestring必填
发布评论的用户名
starint32必填
用户提供的评分(范围:1 到 5)
likeint32必填
评论的点赞数
created_atstring必填
评论创建时间,格式:YYYY-MM-DD HH:mm:ss
contentstring必填
评论内容
countrystring
评论所属国家代码(如 CN、US)
imagesstring[]
评论图片, URL以分号分隔
{
"comment": {
"product_id": "string",
"user_name": "string",
"star": 0,
"like": 0,
"created_at": "string",
"content": "string",
"country": "string",
"images": [
"string"
]
}
}
响应
- 200
OK
- application/json
- 数据结构
- 示例
数据结构
codestring
错误码
messagestring
错误信息
data object
comment object
评论
idint32
评论的唯一标识
store_idint32
评论创建所在店铺的 ID
user_namestring
发布评论的用户名
emailstring
用户的电子邮件地址(如已提供)
starstring
用户提供的评分
likeint32
评论的点赞数
contentstring
评论内容
imagesstring[]
评论图片 URL 列表
statusint32
评论状态:1 为已发布,0 为未发布
typeint32
评论类型
product_idstring
与评论关联的商品 ID
created_atstring
评论创建时间,ISO-8601 格式:YYYY-MM-DD HH:mm:ss
updated_atstring
评论最后更新时间,ISO-8601 格式
countrystring
评论创建所在国家代码
is_featuredint32
评论是否为精选(0:否,1:是)
is_verifiedint32
评论是否已验证(0:否,1:是)
client_idstring
创建评论的客户端 ID
anonymousint32
评论是否匿名发布(0:否,1:是)
product_publishedint32
商品是否已发布
{
"code": "string",
"message": "string",
"data": {
"comment": {
"id": 0,
"store_id": 0,
"user_name": "string",
"email": "string",
"star": "string",
"like": 0,
"content": "string",
"images": [
"string"
],
"status": 0,
"type": 0,
"product_id": "string",
"created_at": "string",
"updated_at": "string",
"country": "string",
"is_featured": 0,
"is_verified": 0,
"client_id": "string",
"anonymous": 0,
"product_published": 0
}
}
}