创建一个产品

POST

/api/v1/products

Products

在主数据中创建一个新产品。此操作是幂等的，支持上游系统推送产品数据。

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

Authorization: ********************

Header 参数

Body 参数application/json必填

示例

{
    "params": {
        "custom_field": "some_value",
        "another_field": {
            "nested": true
        }
    },
    "spuCode": "SPU-001",
    "upc": "123456789012",
    "sku": "WIDGET-001",
    "skuName": "Premium Quality Widget",
    "amazonFnSku": "FN-SKU-001",
    "serialNumber": "SN-001",
    "dimensions": {
        "lengthCm": 20.5,
        "widthCm": 10.5,
        "heightCm": 5.5,
        "lengthInch": 8.07,
        "widthInch": 4.13,
        "heightInch": 2.17,
        "metricVolume": 1127.5,
        "imperialVolume": 68.83
    },
    "weight": {
        "weightKg": 1.25,
        "weightLb": 2.76
    },
    "packaging": {
        "packageLengthCm": 25.5,
        "packageWidthCm": 15.5,
        "packageHeightCm": 10.5,
        "packageLengthInch": 10.04,
        "packageWidthInch": 6.1,
        "packageHeightInch": 4.13,
        "packageWeightKg": 1.5,
        "packageWeightLb": 3.31,
        "packageMetricVolume": 4144.13,
        "packageImperialVolume": 252.93
    },
    "pricing": {
        "value": 99.99,
        "currency": "USD"
    },
    "attributes": {
        "containingElectric": false,
        "dangerousGoods": false,
        "needsPackaging": true,
        "multiItemIndependentPackaging": false,
        "packagingMaterial": false,
        "serialNumberManagement": false
    },
    "imageUrl": "https://example.com/product-image.jpg"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://gwms.jmalltech.com/api-gateway/api/v1/products' \
--header 'Idempotency-Key;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "params": {
        "custom_field": "some_value",
        "another_field": {
            "nested": true
        }
    },
    "spuCode": "SPU-001",
    "upc": "123456789012",
    "sku": "WIDGET-001",
    "skuName": "Premium Quality Widget",
    "amazonFnSku": "FN-SKU-001",
    "serialNumber": "SN-001",
    "dimensions": {
        "lengthCm": 20.5,
        "widthCm": 10.5,
        "heightCm": 5.5,
        "lengthInch": 8.07,
        "widthInch": 4.13,
        "heightInch": 2.17,
        "metricVolume": 1127.5,
        "imperialVolume": 68.83
    },
    "weight": {
        "weightKg": 1.25,
        "weightLb": 2.76
    },
    "packaging": {
        "packageLengthCm": 25.5,
        "packageWidthCm": 15.5,
        "packageHeightCm": 10.5,
        "packageLengthInch": 10.04,
        "packageWidthInch": 6.1,
        "packageHeightInch": 4.13,
        "packageWeightKg": 1.5,
        "packageWeightLb": 3.31,
        "packageMetricVolume": 4144.13,
        "packageImperialVolume": 252.93
    },
    "pricing": {
        "value": 99.99,
        "currency": "USD"
    },
    "attributes": {
        "containingElectric": false,
        "dangerousGoods": false,
        "needsPackaging": true,
        "multiItemIndependentPackaging": false,
        "packagingMaterial": false,
        "serialNumberManagement": false
    },
    "imageUrl": "https://example.com/product-image.jpg"
}'

返回响应

🟢201已创建

application/json

产品已成功创建。

Body

示例

{
    "success": true,
    "message": "Success",
    "code": "200",
    "timestamp": "2024-01-01T00:00:00Z",
    "data": {
        "createBy": 1,
        "createTime": "2024-01-01T10:00:00Z",
        "updateBy": 1,
        "updateTime": "2024-01-01T10:30:00Z",
        "params": {
            "key1": "value1",
            "key2": "value2"
        },
        "id": 12345,
        "userId": 1001,
        "spuCode": "SPU-001",
        "upc": "123456789012",
        "sku": "WIDGET-001",
        "skuName": "Premium Quality Widget",
        "skuCode": "EXT-WIDGET-001",
        "gsku": "GSKU-001",
        "amazonFnSku": "FN-SKU-001",
        "serialNumber": "SN-001",
        "dimensions": {
            "lengthCm": 20.5,
            "widthCm": 10.5,
            "heightCm": 5.5,
            "lengthInch": 8.07,
            "widthInch": 4.13,
            "heightInch": 2.17,
            "metricVolume": 1127.5,
            "imperialVolume": 68.83
        },
        "weight": {
            "weightKg": 1.25,
            "weightLb": 2.76
        },
        "packaging": {
            "packageLengthCm": 25.5,
            "packageWidthCm": 15.5,
            "packageHeightCm": 10.5,
            "packageLengthInch": 10.04,
            "packageWidthInch": 6.1,
            "packageHeightInch": 4.13,
            "packageWeightKg": 1.5,
            "packageWeightLb": 3.31,
            "packageMetricVolume": 4144.13,
            "packageImperialVolume": 252.93
        },
        "pricing": {
            "value": 99.99,
            "currency": "USD"
        },
        "attributes": {
            "containingElectric": false,
            "dangerousGoods": false,
            "needsPackaging": true,
            "multiItemIndependentPackaging": false,
            "packagingMaterial": false,
            "serialNumberManagement": false
        },
        "imageUrl": "https://example.com/product-image.jpg",
        "status": "ACTIVE"
    }
}

🟠400请求有误

🟠401未认证

🟠409冲突

🔴500服务器内部错误

修改于 2025-09-10 07:08:13

列出产品

批量创建产品