添加商品

POST

/shop/goods

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

goods

object (Goods)

可选

createTime

string | null

创建时间

可选

updateTime

string | null

更新时间

可选

integer | null

可选

goodsSn

string | null

商品编号

可选

name

string | null

商品名称

必需

categoryId

integer | null

商品所属类目ID

可选

>= 0

brandId

integer | null

可选

gallery

array[string] | null

可选

商品宣传图片列表，采用JSON数组格式

keywords

string | null

可选

商品关键字，采用逗号间隔

brief

string | null

商品简介

可选

isOnSale

boolean | null

可选

是否上架（0代表为上架 1代表上架）

sort

integer | null

排序

可选

picUrl

string | null

商品页面商品图片

可选

shareUrl

string | null

商品分享海报

可选

isNew

boolean | null

可选

是否新品首发，如果设置则可以在新品首发页面展示

isHot

boolean | null

可选

是否人气推荐，如果设置则可以在人气推荐页面展示

unit

string | null

必需

商品单位，例如件、盒

counterPrice

number | null

专柜价格

可选

retailPrice

number | null

零售价格

可选

actualSales

integer | null

实际销量

可选

virtualSales

integer | null

虚拟销量

可选

detail

string | null

可选

商品详细介绍，是富文本格式

delFlag

boolean | null

可选

删除标志（0代表存在 1代表删除）

specifications

array[object (GoodsSpecification[]) {8}] | null

可选

createTime

string | null

创建时间

可选

updateTime

string | null

更新时间

可选

integer | null

可选

goodsId

integer | null

商品表的商品ID

可选

specification

string | null

商品规格名称

可选

value

string | null

商品规格值

必需

picUrl

string | null

商品规格图片

可选

delFlag

boolean | null

逻辑删除

可选

attributes

array[object (GoodsAttribute[]) {7}] | null

可选

createTime

string | null

创建时间

可选

updateTime

string | null

更新时间

可选

integer | null

可选

goodsId

integer | null

商品表的商品ID

可选

attribute

string | null

商品参数名称

可选

value

string | null

商品参数值

可选

delFlag

boolean | null

可选

删除标志（0代表存在 1代表删除）

products

array[object (GoodsProduct[]) {10}] | null

可选

createTime

string | null

创建时间

可选

updateTime

string | null

更新时间

可选

integer | null

可选

goodsId

integer | null

商品表的商品ID

可选

specifications

array[string] | null

可选

商品规格值列表，采用JSON数组格式

>= 1 items

price

number | null

商品货品价格

可选

>= 0.0001

defaultSelected

boolean | null

可选

是否默认选中（0代表选中 1代表未选中）

number

integer | null

商品货品数量

可选

>= 0

url

string | null

商品货品图片

可选

delFlag

boolean | null

可选

删除标志（0代表存在 1代表删除）

示例

{
  "goods": {
    "createTime": "string",
    "updateTime": "string",
    "id": 0,
    "goodsSn": "string",
    "name": "string",
    "categoryId": 0,
    "brandId": 0,
    "gallery": [
      "string"
    ],
    "keywords": "string",
    "brief": "string",
    "isOnSale": true,
    "sort": 0,
    "picUrl": "string",
    "shareUrl": "string",
    "isNew": true,
    "isHot": true,
    "unit": "string",
    "counterPrice": 0,
    "retailPrice": 0,
    "actualSales": 0,
    "virtualSales": 0,
    "detail": "string",
    "delFlag": true
  },
  "specifications": [
    {
      "createTime": "string",
      "updateTime": "string",
      "id": 0,
      "goodsId": 0,
      "specification": "string",
      "value": "string",
      "picUrl": "string",
      "delFlag": true
    }
  ],
  "attributes": [
    {
      "createTime": "string",
      "updateTime": "string",
      "id": 0,
      "goodsId": 0,
      "attribute": "string",
      "value": "string",
      "delFlag": true
    }
  ],
  "products": [
    {
      "createTime": "string",
      "updateTime": "string",
      "id": 0,
      "goodsId": 0,
      "specifications": [
        "string"
      ],
      "price": 0.0001,
      "defaultSelected": true,
      "number": 0,
      "url": "string",
      "delFlag": true
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://localhost:81/shop/goods' \
--header 'Content-Type: application/json' \
--data-raw '{
    "goods": {
        "createTime": "string",
        "updateTime": "string",
        "id": 0,
        "goodsSn": "string",
        "name": "string",
        "categoryId": 0,
        "brandId": 0,
        "gallery": [
            "string"
        ],
        "keywords": "string",
        "brief": "string",
        "isOnSale": true,
        "sort": 0,
        "picUrl": "string",
        "shareUrl": "string",
        "isNew": true,
        "isHot": true,
        "unit": "string",
        "counterPrice": 0,
        "retailPrice": 0,
        "actualSales": 0,
        "virtualSales": 0,
        "detail": "string",
        "delFlag": true
    },
    "specifications": [
        {
            "createTime": "string",
            "updateTime": "string",
            "id": 0,
            "goodsId": 0,
            "specification": "string",
            "value": "string",
            "picUrl": "string",
            "delFlag": true
        }
    ],
    "attributes": [
        {
            "createTime": "string",
            "updateTime": "string",
            "id": 0,
            "goodsId": 0,
            "attribute": "string",
            "value": "string",
            "delFlag": true
        }
    ],
    "products": [
        {
            "createTime": "string",
            "updateTime": "string",
            "id": 0,
            "goodsId": 0,
            "specifications": [
                "string"
            ],
            "price": 0.0001,
            "defaultSelected": true,
            "number": 0,
            "url": "string",
            "delFlag": true
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer | null

可选

返回状态码：返回200表示请求接口成功，非200表示请求接口失败

msg

string | null

返回消息

可选

data

boolean | null

返回数据

可选

示例

{
  "code": 0,
  "msg": "",
  "data": false
}

修改于 2024-05-06 03:44:54

商品列表

添加商品