文档
测试

分页查询可代发的商品

POST
请求地址/router

请求地址

|环境|服务地址(HTTP/HTTPS)| |-|-| |V2正式环境(推荐)| https://gw.superboss.cc/router| |V2测试环境| https://gw3.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
multipart/form-data
必填

API接口地址

参数名
类型
描述
必填
method
string
kmt.api.dms.query.page.distributor.item
必填

请求参数

参数名
类型
描述
必填
distributorCompanyId
long
分销商公司id
必填
supplierCompanyId
long
供销商公司id
必填
outerIds
List<String>
款编码
可选
skuOuterIds
List<String>
sku编码
可选
title
string
商品标题
可选
pageNo
int
pageNo
必填
pageSize
int
pageSize
必填
ifReturenParamSku
boolean
是否只返回sku编码参数中的sku, 默认false 返回整款,true只返回sku编码参数中的sku
必填

请求示例

示例一: ----------------- ```` { } ````

响应参数

参数名
类型
描述
必填
success
boolean
示例:true
必填
trace_id
string
示例:3553483395407017
必填
total
int
总数量,示例:10
必填
traceId
string
示例:2875616517097524937
必填
data
array
数据列表
必填
bindFlag
boolean
是否已绑定,示例:false
必填
companyId
int
公司id,示例:30482
必填
baseItemId
string
KMT商品id,示例:3f00c32622d0000
必填
mainImages
string
主图,示例:["https://erp-storage-ram.oss-cn-hangzhou.aliyuncs.com/scm/30482/1689588120849/5dc57269-cfef-4987-9b48-dd3db74d9bc2.jpeg.a.jpeg"]
必填
outerId
string
款编码,示例:20237170001纯商品123
必填
title
string
商品标题,示例:11fd53cc
必填
levelDistributionPrice
double
分销价(如果是纯商品,没有sku,展示分销价取款维度的)
必填
distributorSkuList
array
sku
必填
title
string
商品标题,示例:11fd53cc
必填
bindFlag
boolean
是否绑定,示例:false
必填
companyId
int
公司id,示例:30482
必填
baseItemId
string
KMT商品id,示例:3f00c32622d0000
必填
imageUrl
string
sku图片,示例:https://erp-storage-ram.oss-cn-hangzhou.aliyuncs.com/scm/30482/1690534513273/28.jpg
必填
outerId
string
款编码,示例:20237170001纯商品123
必填
id
int
KMT-SKU-ID,示例:28613
必填
skuOuterId
string
SKU编码,示例:20237170001纯商品23s
必填
skuSpecifications
string
规格json,示例:[{"checked":true,"imageUrl":"https://erp-storage-ram.oss-cn-hangzhou.aliyuncs.com/scm/30482/1690534513273/28.jpg","name":"颜色","nameKey":"颜色","value":"23","valueKey":"23"},{"checked":true,"name":"尺码","nameKey":"尺码","value":"s","valueKey":"s"}]
必填
levelDistributionPrice
double
分销价
必填

异常示例

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

错误码解释

| 错误码 |错误信息|解决方案| |-|-|-| |content1|content2|content3|