创建评论

POST 
/openapi/2026-07/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
    }
  }
}