开发指南
API
官网
API 2.0
API 2.0 > 3.1 商品 > 3.1.14 批量上下架/删除商品

3.1.14 批量上下架/删除商品

开启令牌和权限后可调用。签名方式请查看开发指南
场景描述：根据商品编码批量更新当前店铺商品上下架、删除
零售 餐饮 平台零售 平台餐饮

请求地址

请求方式 版本信息 请求地址
POST V2 http://openapi.zvcms.com/api/v2

公共参数

参数 参数类型 是否必填 默认值 描述
OpenId string 是 密钥Id
GrantCode string 是 授权code
Token string 是 签名，参考《数字签名sign》
Timestamp string 是 当前时间戳
Nonce string 是 随机正整数
Action string 是 goods.goods-batch-manage 接口方法
Params array 是 业务参数

请求参数

参数 参数类型 是否必填 默认值 描述
ids array 是 商品id数组 ， 商品删除接口时只传 ids
sales_status sales_status 是 上下架状态（on or off） 上下架时传此字段，删除时不传

响应参数

参数 参数类型 描述

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "goods.goods-batch-manage",
    "Params": {
        "ids": "[1,2]",
        "sales_status": ""
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": []
}

异常示例

{
    "status": true,
    "code": "异常编码，根据不同的业务返回编码",
    "message": "异常说明：查询的信息不存在"
}

错误码

{
    "status": false,
    "code": "系统错误编码：详见全局返回编码",
    "message": "系统错误说明"
}

请求地址

请求方式 版本信息 请求地址
POST V2 http://openapi.zvcms.com/api/v2

公共参数

参数 参数类型 是否必填 默认值 描述
OpenId string 是 密钥Id
GrantCode string 是 授权code
Token string 是 签名，参考《数字签名sign》
Timestamp string 是 当前时间戳
Nonce string 是 随机正整数
Action string 是 goods.goods-batch-manage 接口方法
Params array 是 业务参数

请求参数

参数 参数类型 是否必填 默认值 描述
goods array 否
 ├0 int 是 商品id，支持批量处理，商品id以数组的形式传递
status int 是 操作参数。0删除 ,1 上架 ，2下架

响应参数

参数 参数类型 描述
status bool 成功或失败
code int 成功/错误编码
message string 成功/错误描述

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "goods.goods-batch-manage",
    "Params": {
        "goods": [
            "10001"
        ],
        "status": "2"
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "status": "",
        "code": "",
        "message": ""
    }
}

异常示例

{
    "status": true,
    "code": "异常编码，根据不同的业务返回编码",
    "message": "异常说明：查询的信息不存在"
}

错误码

{
    "status": false,
    "code": "系统错误编码：详见全局返回编码",
    "message": "系统错误说明"
}

请求地址

请求方式 版本信息 请求地址
POST V2 http://openapi.zvcms.com/api/v2

公共参数

参数 参数类型 是否必填 默认值 描述
OpenId string 是 密钥Id
GrantCode string 是 授权code
Token string 是 签名，参考《数字签名sign》
Timestamp string 是 当前时间戳
Nonce string 是 随机正整数
Action string 是 goods.goods-batch-manage 接口方法
Params array 是 业务参数

请求参数

参数 参数类型 是否必填 默认值 描述
id array 是 商品id，支持数组
shelve int 否 1 上下架操作 1 上架 0 下架

响应参数

参数 参数类型 描述

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "goods.goods-batch-manage",
    "Params": {
        "id": "",
        "shelve": "1"
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": []
}

异常示例

{
    "status": true,
    "code": "异常编码，根据不同的业务返回编码",
    "message": "异常说明：查询的信息不存在"
}

错误码

{
    "status": false,
    "code": "系统错误编码：详见全局返回编码",
    "message": "系统错误说明"
}

请求地址

请求方式 版本信息 请求地址
POST V2 http://openapi.zvcms.com/api/v2

公共参数

参数 参数类型 是否必填 默认值 描述
OpenId string 是 密钥Id
GrantCode string 是 授权code
Token string 是 签名，参考《数字签名sign》
Timestamp string 是 当前时间戳
Nonce string 是 随机正整数
Action string 是 goods.goods-batch-manage 接口方法
Params array 是 业务参数

请求参数

参数 参数类型 是否必填 默认值 描述
id array 是 商品id，支持数组
shelve int 否 1 上下架操作 1 上架 0 下架

响应参数

参数 参数类型 描述

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "goods.goods-batch-manage",
    "Params": {
        "id": "",
        "shelve": "1"
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": []
}

异常示例

{
    "status": true,
    "code": "异常编码，根据不同的业务返回编码",
    "message": "异常说明：查询的信息不存在"
}

错误码

{
    "status": false,
    "code": "系统错误编码：详见全局返回编码",
    "message": "系统错误说明"
}

免费升级

营销功能、插件持续每月更新开发升级

免费专业培训

每月建站、微信营销、电商等互联网增值培训

7×24小时服务支持

400电话、QQ、微信、在线等多渠道售后支持

 

安徽智迈科技股份有限公司 版权所有 Copyright 2009-2018 皖公网安备 34019202000074号 增值电信业务经营许可证：皖B2-20170075