探马OpenAPI

导入商城商品

POST

/api/v1/h5_spu/replace

批量导入商品需指定商城ID ，此为增量数据，可修改，新增，删除必填商品ID 根据商品ID 进行匹配进行数据操作，deleted 为0 表示未删除商品，填入非0数字表示将删除该商品
限制：10000条

请求参数

Header 参数

appId

string

应用 appId

必需

默认值:

timestamp

string

请求时间戳

必需

默认值:

sign

string

请求消息签名值

必需

默认值:

appKey

string

应用 appKey

可选

默认值:

Body 参数application/json

每次最多导入10000条数据

array of:

spuId

integer

商品spuId

必需

picture

string

商品图片

必需

goodsName

string

商品名称

必需

goodsDesc

string

商品描述

必需

price

integer

商品价格

必需

originPrice

integer

商品原价（划线价）

必需

shopId

string

商城ID

必需

goodsType

integer

0-小程序 1-链接不填为0

可选

goodsUrl

string

商品链接/小程序链接

必需

goodsDetail

string

商品详情（富文本字符）

可选

deleted

integer

为0的时候是新增或者修改（spuId冲突的时候修改，spuId不存在的时候新增），当deleted 不为0的时候，为删除，deleted传递的删除时间的时间戳

必需

categoryId

integer

商品类别

必需

appId

string

绑定小程序的appid

可选

如果跳转自己系统绑定的小程序，需要指定appid
如果跳转探马后台绑定的小程序，可不指定appid

示例

[
    {
        "spuId": 17,
        "picture": "http://dummyimage.com/400x400",
        "goodsName": "此联通各求",
        "goodsDesc": "esse",
        "price": 40,
        "originPrice": 2,
        "shopId": "13",
        "goodsUrl": "http://rmwf.sg/jgbutqcvu",
        "deleted": 40,
        "categoryId": 38,
        "goodsType": 8,
        "goodsDetail": "mollit non ex laborum minim",
        "appId": "53"
    },
    {
        "spuId": 19,
        "picture": "http://dummyimage.com/400x400",
        "goodsName": "习事取民义",
        "goodsDesc": "laborum commodo voluptate occaecat",
        "price": 81,
        "originPrice": 2,
        "shopId": "11",
        "goodsUrl": "http://tbokabeu.sg/awtogmxh",
        "deleted": 43,
        "categoryId": 76,
        "appId": "35",
        "goodsDetail": "labore Lorem aliquip proident id",
        "goodsType": 2
    },
    {
        "spuId": 20,
        "picture": "http://dummyimage.com/400x400",
        "goodsName": "至位们学较作感",
        "goodsDesc": "esse exercitation ea ex",
        "price": 8,
        "originPrice": 81,
        "shopId": "80",
        "goodsUrl": "http://uthgej.sl/xwfremq",
        "deleted": 68,
        "categoryId": 25,
        "appId": "19",
        "goodsType": 19,
        "goodsDetail": "commodo sint mollit non sed"
    }
]

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v1/h5_spu/replace' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "spuId": 17,
        "picture": "http://dummyimage.com/400x400",
        "goodsName": "此联通各求",
        "goodsDesc": "esse",
        "price": 40,
        "originPrice": 2,
        "shopId": "13",
        "goodsUrl": "http://rmwf.sg/jgbutqcvu",
        "deleted": 40,
        "categoryId": 38,
        "goodsType": 8,
        "goodsDetail": "mollit non ex laborum minim",
        "appId": "53"
    },
    {
        "spuId": 19,
        "picture": "http://dummyimage.com/400x400",
        "goodsName": "习事取民义",
        "goodsDesc": "laborum commodo voluptate occaecat",
        "price": 81,
        "originPrice": 2,
        "shopId": "11",
        "goodsUrl": "http://tbokabeu.sg/awtogmxh",
        "deleted": 43,
        "categoryId": 76,
        "appId": "35",
        "goodsDetail": "labore Lorem aliquip proident id",
        "goodsType": 2
    },
    {
        "spuId": 20,
        "picture": "http://dummyimage.com/400x400",
        "goodsName": "至位们学较作感",
        "goodsDesc": "esse exercitation ea ex",
        "price": 8,
        "originPrice": 81,
        "shopId": "80",
        "goodsUrl": "http://uthgej.sl/xwfremq",
        "deleted": 68,
        "categoryId": 25,
        "appId": "19",
        "goodsType": 19,
        "goodsDetail": "commodo sint mollit non sed"
    }
]'

返回响应

🟢200成功

application/json

Body

code

integer

响应码

必需

message

string

响应信息

必需

示例

成功示例异常示例

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

修改于 2023-03-27 08:14:58

导入商城商品类别

概述