探马OpenAPI

导入商城商品类别

POST

/api/v1/h5_spu/category

类别为全量类别数据，若原始类别已不存在则无法根据类别查询商品

请求参数

Header 参数

appId

string

应用 appId

必需

默认值:

timestamp

string

请求时间戳

必需

默认值:

sign

string

请求消息签名值

必需

默认值:

appKey

string

应用 appKey

可选

默认值:

Body 参数application/json

shopId

string

商城ID

必需

categoryList

array [object {6}]

商品类型

必需

全量商品类型数据

categoryId

integer

类别ID

必需

categoryName

string

类别名称

必需

parentCategoryId

integer

父类别ID

必需

上级类别ID 0-顶级类别

categoryLevel

integer

级别

必需

1-一级类别，2-二级类别，3-三级类别类推

deleted

integer

是否删除

必需

0-未删除，非0-已删除（一般为时间戳）

departmentIds

array[number]

类别的适用部门

可选

设置适用部门后，只有在该部门或者其子部门的人员可以查看到对应的类别及类别中的商品，适用部门只对顶级部门有效

示例

{
    "shopId":"apple_shop",
    "categoryList":[
        {
            "categoryId":1,
            "categoryName":"男装",
            "parentCategoryId":0,
            "categoryLevel": 1,
            "deleted":0,
            "departmentIds":[1589,3652]
        },
        {
            "categoryId":2,
            "categoryName":"女装",
            "parentCategoryId":0,
            "categoryLevel": 1,
            "deleted":0,
            "departmentIds":[6352,6668]
        },
        {
            "categoryId":3,
            "categoryName":"精品男装",
            "parentCategoryId":1,
            "categoryLevel": 2,
            "deleted":0
        },
        {
            "categoryId":4,
            "categoryName":"精品女装",
            "parentCategoryId":2,
            "categoryLevel": 2,
            "deleted":0
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v1/h5_spu/category' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "shopId":"apple_shop",
    "categoryList":[
        {
            "categoryId":1,
            "categoryName":"男装",
            "parentCategoryId":0,
            "categoryLevel": 1,
            "deleted":0,
            "departmentIds":[1589,3652]
        },
        {
            "categoryId":2,
            "categoryName":"女装",
            "parentCategoryId":0,
            "categoryLevel": 1,
            "deleted":0,
            "departmentIds":[6352,6668]
        },
        {
            "categoryId":3,
            "categoryName":"精品男装",
            "parentCategoryId":1,
            "categoryLevel": 2,
            "deleted":0
        },
        {
            "categoryId":4,
            "categoryName":"精品女装",
            "parentCategoryId":2,
            "categoryLevel": 2,
            "deleted":0
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

响应码

必需

message

string

响应信息

必需

示例

成功示例异常示例

{
    "code": 0,
    "message": "success"
}

修改于 2022-09-15 08:58:53

注册商城

导入商城商品