文档

测试

查询单个商品明细

websocket测试

POST

请求地址/router

接口描述

用于获取单个商品sku信息。支持获取指定主商品下的sku商品信息，包括普通商品，套件商品、组合商品、加工商品

系统相关界面

"界面路径：【商品】----【商品档案】----【编辑】"

请求地址

|环境|服务地址(HTTP/HTTPS)| |-|-| |V2正式环境（推荐）| https://gw.superboss.cc/router| **2022年4月1日**以后申请的APP Key，统一使用V2正式环境的请求地址：**https://gw.superboss.cc/router**

公共参数

调用任何一个API都必须传入的参数，目前支持的公共参数有： | 参数名称 | 参数类型 | 是否必须 | 参数描述 | | --- | --- | --- | --- | | method | string | 是 | API接口名称 | | appKey | string | 是 | 分配给应用的AppKey | | timestamp | string | 是 | 时间戳，时区为GMT+8，例如：2020-09-21 16:58:00。API服务端允许客户端请求最大时间误差为10分钟 | | format | string | 否 | 响应格式。默认为json格式，可选值：json | | version | string | 是 | API协议版本可选值：1.0 | | sign\_method | string | 否 | 签名的摘要算法(默认 hmac)，可选值为：hmac，md5，hmac-sha256。 | | sign | string | 是 | 签名 | | session | string | 是 | 授权会话信息（即access_token，由系统分配） |

请求头

参数名

类型

描述

必填

Content-Type

string

application/x-www-form-urlencoded

必填

API接口地址

参数名

类型

描述

必填

method

string

item.single.get

必填

请求参数

参数名

类型

描述

必填

outerId

string

平台商家编码（同系统主商品ID二选一，优先取系统主商品ID）

可选

sysItemId

long

系统主商品ID（同平台商家编码二选一，优先取系统主商品ID）

可选

whetherReturnPurchase

integer

是否返回采购链接，0.否 1.是，默认不返回

可选

请求示例

示例一： ----------------- ```` { "outerId":"string" } ```` 示例二： ----------------- ```` { "sysItemId":long } ````

响应参数

参数名

类型

描述

item

object

数据字典

sysItemId

long

系统主商品ID

shortTitle

string

商品简称

weight

double

重量，单位kg

barcode

string

条形码

picPath

string

商品图片URL

activeStatus

integer

数据的可用状态，0表示停用，1表示启用

title

string

商品标题

outerId

string

平台商家编码

type

string

商品类型 0-普通（含虚拟商品，用 isVirtual字段描述|组合装商品） 1-sku套件 2-纯套件 3-包材商品

typeTag

integer

基于type下的二级分类 type=0 : 0-正常商品，1-sku加工商品，2-纯加工商品 3-含sku组合装商品 4-不含sku组合装商品

catId

string

商品类目

unit

string

单位

isSkuItem

integer

是否是含有sku的商品，是：1，否：0

isVirtual

integer

是否是虚拟商品，是：1，否：0

hasSupplier

integer

是否关联供应商是：1 否：0

makeGift

boolean

是否标记为赠品，true：标记 false：未标记

created

long

创建时间

modified

long

更新时间

sellerCids

string

分类编码，多个以逗号隔开

sellerCats

array

分类列表

long

分类id，示例：94385

cid

long

分类编码，示例：-1

name

string

分类名称，示例：未分类

purchasePrice

double

成本价

priceOutput

double

销售价

double

长

double

宽

double

高

purchaseLinkSkuList

array

采购链接

outerId

string

商家编码

skuOuterId

string

规格商家编码

sysItemId

long

系统主商品ID

sysSkuId

long

系统商品skuId

purchaseLinkList

array

采购链接详情

defaultFlag

boolean

默认标识

link

string

链接

source

string

来源

sourceName

string

来源名称

listTime

long

上架日期

boxnum

int

箱规

suitSingleList

array

套件明细

outerId

string

平台商家编码

title

string

商品名称

ratio

int

组合比例

skuOuterId

string

规格商家编码

propertiesName

string

规格属性

success

boolean

示例：true

trace_id

string

示例：3553483395407017

响应示例

``` { "item": { "sysItemId": long, "barcode": "string", "picPath": "string", "activeStatus": long, "title": "string", "outerId": "string", "type": "string", "typeTag": long, "catId": "string", "unit": "string", "isSkuItem": long, "isVirtual": long, "hasSupplier": long, "makeGift": boolean, "created": long, "modified": long, "sellerCids": "string", "sellerCats": [ { "id": long, "cid": long, "name": "string" } ] }, "success": boolean, "trace_id": "long" } ```

异常示例

```` { "code": "25", "msg": "服务方法(item.single.get:1.0)的签名无效", "success": false, "trace_id": "3553483395423660" } ````

错误码解释

| 错误码 |错误信息|解决方案| |-|-|-| |20105|系统主商品ID与平台商家编码，必须二选一！|系统主商品ID与平台商家编码，必须二选一！| |20110|查询商品信息有误|请根据返回错误信息进行处理|

上一篇查询商品列表

nextDoc 查询商品SKU信息