**版本：202601**

# 批量创建评论

**POST** `/openapi/2026-01/comments/batch`

批量为商品创建评论。

## 请求

**application/json**

**请求体 | 示例**

**请求体 (required)**

- `comments` object[] (required)

  评论列表

  *   Array \[

  - `product_id` string (required)

    评论所属商品的 ID
  - `user_name` string (required)

    发布评论的用户名
  - `star` int32 (required)

    用户提供的评分（范围：1 到 5）
  - `like` int32 (required)

    评论的点赞数
  - `created_at` string (required)

    评论创建时间，格式：YYYY-MM-DD HH:mm:ss
  - `content` string (required)

    评论内容
  - `country` string

    评论所属国家代码（如 CN、US）
  - `images` string[]

    评论图片, URL以分号分隔
  *   \]

```json
{
  "comments": [
    {
      "product_id": "string",
      "user_name": "string",
      "star": 0,
      "like": 0,
      "created_at": "string",
      "content": "string",
      "country": "string",
      "images": [
        "string"
      ]
    }
  ]
}
```

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `success_count` int32

    成功数量
  - `error_count` int32

    错误数量
  - `error_infos` object[]

    错误信息列表

    *   Array \[

    - `product_id` string

      评论所属商品的 ID
    - `user_name` string

      发布评论的用户名
    - `star` int32

      用户提供的评分（范围：1 到 5）
    - `like` int32

      评论的点赞数
    - `created_at` string

      评论创建时间，格式：YYYY-MM-DD HH:mm:ss
    - `content` string

      评论内容
    - `country` string

      评论所属国家代码（如 CN、US）
    - `images` string[]

      评论图片，URL以分号分隔
    - `product_published` int32

      商品是否已发布
    - `error_message` string

      说明评论处理失败原因的错误信息
    *   \]

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "success_count": 0,
    "error_count": 0,
    "error_infos": [
      {
        "product_id": "string",
        "user_name": "string",
        "star": 0,
        "like": 0,
        "created_at": "string",
        "content": "string",
        "country": "string",
        "images": [
          "string"
        ],
        "product_published": 0,
        "error_message": "string"
      }
    ]
  }
}
```