数字化供应链 接口文档
  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

POST
/v2/GoodsGroup/ApiGoodsList

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

请求参数参考如下:
{"page":1,"limit":20,"source":2,"agreement_price":{"from":20,"to":30},"guide_price":{"from":20,"to":30},"activity_price":{"from":20,"to":30},"promote_rate":{"from":20,"to":30},"activity_rate":{"from":20,"to":30},"type":"agreement_price","sort":"desc","is_free_shipping":1,"shop_words":"苹果","search_words":"电脑"}

请求参数

Header 参数
Content-Type
string 
必需
示例值:
application/json
Body 参数application/json
page
number 
页码
必需
limit
number 
页数
必需
group_id
number 
可选
分组id(不传默认为选品库全部商品)0为未分组
source
number 
可选
平台来源1平台来源1生态云仓11自营云仓2鲸选6阿里16跨境一仓12特卖一仓14华东一仓18厂家直销19云仓优选20天猫优选21苏宁
agreement_price
object 
可选
内部元素from,to协议价范围(元)
from
number 
可选
to
number 
可选
guide_price
object 
可选
内部元素from,to指导价范围(元)
from
number 
可选
to
number 
可选
activity_price
object 
可选
内部元素from,to营销价范围(元)
from
number 
可选
to
number 
可选
promotion_rate
object 
可选
内部元素from,to常规利润率范围(百分比)
from
number 
可选
to
number 
可选
activity_rate
object 
可选
内部元素from,to营销利润率范围(百分比)
from
number 
可选
to
number 
可选
is_free_shipping
number 
可选
0不包邮1包邮-1全部
search_words
string 
关键字
可选
last_id
string 
必需
单独使用,第一次传0,每次返回最后一条商品id循环使用
示例
{
    "page": 0,
    "limit": 0,
    "group_id": 0,
    "source": 0,
    "agreement_price": {
        "from": 0,
        "to": 0
    },
    "guide_price": {
        "from": 0,
        "to": 0
    },
    "activity_price": {
        "from": 0,
        "to": 0
    },
    "promotion_rate": {
        "from": 0,
        "to": 0
    },
    "activity_rate": {
        "from": 0,
        "to": 0
    },
    "is_free_shipping": 0,
    "search_words": "string",
    "last_id": "string"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/v2/GoodsGroup/ApiGoodsList' \
--header 'Content-Type: application/json' \
--data-raw '{
    "page": 0,
    "limit": 0,
    "group_id": 0,
    "source": 0,
    "agreement_price": {
        "from": 0,
        "to": 0
    },
    "guide_price": {
        "from": 0,
        "to": 0
    },
    "activity_price": {
        "from": 0,
        "to": 0
    },
    "promotion_rate": {
        "from": 0,
        "to": 0
    },
    "activity_rate": {
        "from": 0,
        "to": 0
    },
    "is_free_shipping": 0,
    "search_words": "string",
    "last_id": "string"
}'

返回响应

🟢200成功
application/json
Body
msg
string 
操作成功
可选
code
number 
1成功
可选
data
object 
可选
list
array [object {29}] 
可选
count
number 
总数
可选
示例
{
    "msg": "string",
    "code": 0,
    "data": {
        "list": [
            {
                "stock": 0,
                "title": "string",
                "activity_rate": 0,
                "origin": "string",
                "updated_time": 0,
                "cover": "string",
                "third_brand_name": "string",
                "agreement_price": 0,
                "activity_price": 0,
                "sale_price": 0,
                "cost_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"
                ],
                "cloud_shop_id": 0,
                "is_free_shipping": 0,
                "group_ids": [
                    "string"
                ]
            }
        ],
        "count": 0
    }
}
上一页
在线选品v2(新版)
下一页
选品库增加商品v2
Built with