创建一个产品SPU

POST

/api/v1/products/spus

Product SPUs

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

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

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

Header 参数

Body 参数application/json必填

示例

{
    "params": {
        "custom_field": "some_value",
        "another_field": {
            "nested": true
        }
    },
    "spuCode": "SPU-001",
    "productName": "Premium Quality Widget",
    "description": "高品质的产品，适用于多种场景",
    "category": "电子产品",
    "brand": "知名品牌"
}

请求示例代码

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/spus' \
--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",
    "productName": "Premium Quality Widget",
    "description": "高品质的产品，适用于多种场景",
    "category": "电子产品",
    "brand": "知名品牌"
}'

返回响应

🟢201已创建

application/json

产品SPU已成功创建。

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": 0,
        "userId": 0,
        "spuCode": "SPU-001",
        "productName": "Premium Quality Widget",
        "description": "高品质的产品，适用于多种场景",
        "category": "电子产品",
        "brand": "知名品牌",
        "status": "ACTIVE"
    }
}

🟠400请求有误

🟠401未认证

🟠409冲突

🔴500服务器内部错误

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

列出产品SPU

通过SPU编码获取产品SPU