bee-products-create

Version: 2.0.0

Overview

Use the Bee Website Builder Open API to create a new product.

Supports creating products under a specified language and product group, with images, attributes, tags, brief description, and detailed description.

Input Parameters

api_key (string, Required)

API authentication key used to identify the caller and control interface access permissions.

• Get it from: https://open.tradew.com
• Used for API permission validation

language (string, Required)

Publish to the enabled language of the specified enabled site.

⚠️ Must be selected manually from the list returned by bee-languages-get. AI inference or automatic generation is not allowed.

products (object, Required)

Product information.

products.productsgroup_id (integer, Required)

Product group ID.

⚠️ Only leaf groups where is_leaf === true should be selected.
Non-leaf groups should be filtered out and not used. See the product group API for details.

products.product_name (string, Required)

Product name, up to 300 characters.

products.model (string, Optional)

Product model, up to 50 characters.

products.upload_images (array, Optional)

Image upload list, up to 5 images. The first image is the main image.

Each item contains:

products.attributes (array, Optional)

Attribute list, up to 15 items.

Each item contains:

products.tags (array, Optional)

Keyword tag list, up to 6 items. Each tag must be 50 characters or fewer.

products.brief_description (string, Optional)

Brief description in plain text, up to 127 characters.

products.description (string, Optional)

Detailed description in HTML, up to 100,000 characters.

Output Structure

Top-Level Structure

data

Dependencies

Usage Example

{
  "api_key": "your-api-key",
  "language": "en",
  "products": {
    "productsgroup_id": 3445,
    "product_name": "product name",
    "model": "A1386",
    "upload_images": [
      {
        "name": "image1",
        "base64": "image/jpeg;base64,..."
      }
    ],
    "attributes": [
      {
        "name": "color",
        "value": "red"
      }
    ],
    "tags": ["tags 1", "tags 2"],
    "brief_description": "brief description",
    "description": "detailed description"
  }
}

Response Example

{
  "status": true,
  "msg": "create successfully",
  "data": {
    "products_id": 8
  }
}