批量创建产品 - GWMS Public API

支持上游系统批量推送产品数据到WMS系统。适用于ERP系统、电商平台等批量同步产品主数据的场景。批量操作具有事务一致性：要么全部成功创建，要么全部失败。

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

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

Header 参数

Body 参数application/json必填

示例

{
    "params": {
        "custom_field": "some_value",
        "another_field": {
            "nested": true
        }
    },
    "products": [
        {
            "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/batch' \
--header 'Idempotency-Key;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "params": {
        "custom_field": "some_value",
        "another_field": {
            "nested": true
        }
    },
    "products": [
        {
            "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"
        }
    ]
}'

返回响应

🟢200成功

application/json

批量操作成功完成，返回创建的产品ID列表。

Body

示例

{
    "success": true,
    "message": "Success",
    "code": "200",
    "timestamp": "2024-01-01T00:00:00Z",
    "data": {
        "productIds": [
            12345
        ]
    }
}

🟠400请求有误

🟠401未认证

🔴500服务器内部错误