数字化供应链 接口文档
  1. 选品
数字化供应链 接口文档
  • 公共消息
  • 消息说明
  • 商品
    • 获取商品详情v2
      GET
    • 批量获取详情v2
      POST
    • 获取全量分类v2
      GET
    • 获取逐级类目v2
      GET
    • 批量更新商品v2
      POST
  • 选品
    • 选品分组列表v2
      GET
    • 在线选品v2(新版)
      POST
    • 选品分组商品列表v2
      POST
    • 选品库增加商品v2
      GET
    • 选品库商品列表v2
      GET
    • 选品库移除商品v2
      GET
  • 订单
    • 可售检测V2
      GET
    • 前置校验V2
      POST
    • 提交下单V2
      POST
    • 全平台订单列表V2
      GET
    • 各平台订单列表V2
      GET
  • 物流
    • 确认收货
      POST
    • 物流查询v2
      GET
    • 获取物流公司列表V2
      GET
  • 售后
    • 售后前置校验V2
      POST
    • 上传售后凭证(图片)V2
      POST
    • 申请售后V2
      POST
    • 售后列表V2
      GET
    • 售后详情V2
      GET
    • 退货商家邮寄信息
      PATCH
  • 消息
    • 店铺订单取消
    • 商品下架
    • 交易成功
    • 售后同意
    • 商品上架
    • 商品已收货
    • 售后拒绝
    • 商品修改
    • 商家已发货
    • 售后退款到账
    • 商品价格变更
    • 商品库添加
    • 移除商品库商品
  1. 选品

选品库商品列表v2

GET
/v2/GoodsStorage/MyLists

page最大为50,根据不同条件搜索获取商品,如果大于50会触发深度分页造成性能压力(大于50返回为50页数据)(如返回参数本身业务逻辑用不到忽略即可)#

该接口参数与返回值,与商品列表API完全一致(如返回参数本身业务逻辑用不到忽略即可)#

请求参数

Query 参数
page
string 
最大为50
必需
示例值:
1
limit
string 
最大为50
必需
示例值:
10
source
string 
必需
平台来源1生态云仓11自营云仓2鲸选6阿里16跨境一仓12特卖一仓14华东一仓18厂家直销19云仓优选20天猫优选21苏宁
示例值:
0
range_type
string 
可选
区间筛选类型 可选的值:agreement_price 协议价格、activity_price活动价格、guide_price指导价格、promotion_rate 利润率、activity_rate活动利润率
示例值:
agreement_price
range_from
string 
可选
区间开始单位为元,利润率为百分比
示例值:
297
range_to
string 
可选
区间结束单位为元,利润率为百分比
示例值:
299
category_id
string 
可选
分类id(分类列表中的三方分类id)
示例值:
16750
search_words
string 
关键字搜索
可选
示例值:
牙线
commission_agent
string 
可选
0非代理商(获取选品库已选商品);1为代理商(高级商户可获取全部商品,非高级用户获取选品库已选商品);
示例值:
0

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET '/v2/GoodsStorage/MyLists?page=1&limit=10&source=0&range_type=agreement_price&range_from=297&range_to=299&category_id=16750&search_words=牙线&commission_agent=0'

返回响应

🟢200成功
application/json
Body
msg
string 
操作成功
可选
code
number 
1成功
可选
data
object 
可选
list
array [object {26}] 
可选
count
number 
总数
可选
示例
{
    "msg": "string",
    "code": 0,
    "data": {
        "list": [
            {
                "stock": 0,
                "cloud_shop_id": 0,
                "title": "string",
                "activity_rate": 0,
                "origin": "string",
                "updated_time": 0,
                "cover": "string",
                "third_brand_name": "string",
                "agreement_price": 0,
                "activity_price": 0,
                "third_category_name": "string",
                "guide_price": 0,
                "id": 0,
                "source": 0,
                "market_price": 0,
                "status": 0,
                "created_time": 0,
                "third_id": 0,
                "shop_id": 0,
                "real_sale": "string",
                "total_stock": 0,
                "sale": 0,
                "unit": "string",
                "rate": 0,
                "category_ids": [
                    "string"
                ],
                "is_free_shipping": 0
            }
        ],
        "count": 0
    }
}
上一页
选品库增加商品v2
下一页
选品库移除商品v2
Built with