商品列表 - 典典的小卖部

请求参数

Query 参数

pageId

string

可选

默认为1，支持传统的页码分页方式和scroll_id分页方式，根据用户自身需求传入值。示例1：商品入库，则首次传入1，后续传入接口返回的pageid，接口将持续返回符合条件的完整商品列表，该方式可以避免入口商品重复；示例2：根据pagesize和totalNum计算出总页数，按照需求返回指定页的商品（该方式可能在临近页取到重复商品

示例值:

pageSize

string

可选

每页条数，默认为100，最大值200，若小于10，则按10条处理，每页条数仅支持输入10,50,100,200

示例值:

sort

string

可选

排序方式，默认为0，0-综合排序，1-商品上架时间从高到低，2-销量从高到低，3-领券量从高到低，4-佣金比例从高到低，5-价格（券后价）从高到低，6-价格（券后价）从低到高

示例值:

cids

string

可选

大淘客的一级分类id，如果需要传多个，以英文逗号相隔，如：”1,2,3”。当一级类目id和二级类目id同时传入时，会自动忽略二级类目id

subcid

string

可选

大淘客的二级类目id，通过超级分类API获取。仅允许传一个二级id，当一级类目id和二级类目id同时传入时，会自动忽略二级类目id

specialId

string

可选

商品卖点，1.拍多件活动；2.多买多送；3.限量抢购；4.额外满减；6.买商品礼赠

juHuaSuan

string

可选

1-聚划算商品，0-所有商品，不填默认为0

taoQiangGou

string

可选

1-淘抢购商品，0-所有商品，不填默认为0

示例值:

tmall

string

可选

1-天猫商品， 0-非天猫商品，不填默认所有商品

tchaoshi

string

可选

1-天猫超市商品， 0-所有商品，不填默认为0

goldSeller

string

可选

1-金牌卖家商品，0-所有商品，不填默认为0

haitao

string

可选

1-海淘商品， 0-所有商品，不填默认为0

pre

string

可选

1-预告商品，0-所有商品，不填默认为0

preSale

string

可选

1-活动预售商品，0-所有商品，不填默认为0。（10.30新增字段）

brand

string

可选

1-品牌商品，0-所有商品，不填默认为0

brandIds

string

可选

当brand传入0时，再传入brandIds可能无法获取结果。品牌id可以传多个，以英文逗号隔开，如：”345,321,323”

priceLowerLimit

string

价格（券后价）下限

可选

priceUpperLimit

string

价格（券后价）上限

可选

couponPriceLowerLimit

string

最低优惠券面额

可选

commissionRateLowerLimit

string

最低佣金比率

可选

monthSalesLowerLimit

string

最低月销量

可选

freeshipRemoteDistrict

string

可选

偏远地区包邮，1-是，0-非偏远地区，不填默认所有商品

Header 参数

Authorization

string

可选

默认值:

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjEiLCJleHAiOjE2OTU0MzcyMjR9.kbmW-3ddds9YwdKzKMieQOUQmjQdMZYE27N724f16Xk

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200OK

application/json

Body

state

integer <int32>

状态码

可选

message

string

消息提示

可选

data

object (ProductListResultModel)

携带数据

可选

bizSceneId

integer <int64>

可选

list

array[object (DtaokeBaseProduct) {89}]

可选

pageId

string

可选

totalNum

integer <int64>

可选

type

enum<string>

可选

通知类型:Dialog:弹窗,Toast:吐司,Notice:浮层,None:不展示消息,FinalToast:成功或者失败都展示吐司,FinalDialog: 成功或者失败都展示消息弹窗

枚举值:

ToastDialogNoticeNoneFinalToastFinalDialog

redirectUrl

string

可选

重定向URL,不为null需要跳转到这个链接

示例值:

/error?message=token失效&reDirectTo=/orderList

success

boolean

可选

true: 达到预期操作,false: 操作失败,错误信息查看message字段

示例

{
  "state": 0,
  "message": "string",
  "data": {
    "bizSceneId": 0,
    "list": [
      {
        "id": 0,
        "goodsId": "string",
        "goodsSign": "string",
        "title": "string",
        "dtitle": "string",
        "originalPrice": 0,
        "actualPrice": 0,
        "shopType": 0,
        "monthSales": 0,
        "twoHoursSales": 0,
        "dailySales": 0,
        "commissionType": 0,
        "commissionRate": 0,
        "desc": "string",
        "couponReceiveNum": 0,
        "couponTotalNum": 0,
        "couponRemainCount": 0,
        "couponLink": "string",
        "couponId": "string",
        "couponEndTime": "string",
        "couponStartTime": "string",
        "couponPrice": 0,
        "couponConditions": "string",
        "couponShare": "string",
        "activityType": 0,
        "activityStartTime": "string",
        "activityEndTime": "string",
        "shopName": "string",
        "shopLevel": 0,
        "descScore": 0,
        "dsrScore": 0,
        "dsrPercent": 0,
        "shipScore": 0,
        "shipPercent": 0,
        "serviceScore": 0,
        "servicePercent": 0,
        "brand": 0,
        "brandId": 0,
        "brandName": "string",
        "hotPush": 0,
        "teamName": "string",
        "itemLink": "string",
        "quanMLink": 0,
        "hzQuanOver": 0,
        "yunfeixian": 0,
        "estimateAmount": 0,
        "freeshipRemoteDistrict": 0,
        "discountType": 0,
        "discountFull": 0,
        "discountCut": 0,
        "discounts": 0,
        "marketGroup": [
          0
        ],
        "activityInfo": [
          {}
        ],
        "inspectedGoods": 0,
        "divisor": 0,
        "mainPic": "string",
        "marketingMainPic": "string",
        "sellerId": "string",
        "cid": 0,
        "activityId": "string",
        "tbcid": 0,
        "subcid": [
          {}
        ],
        "haitao": 0,
        "tchaoshi": 0,
        "lowest": 0,
        "goldSellers": 0,
        "video": "string",
        "createTime": "string",
        "specialText": [
          {}
        ],
        "directCommissionType": 0,
        "directCommission": 0,
        "directCommissionLink": "string",
        "brandWenan": "string",
        "cpaRewardAmount": 0,
        "previewStartTime": "string",
        "zlowest": "string",
        "zsFullMinusInfo": "string",
        "shopLogo": "string",
        "nineCid": 0,
        "tkZsId": 0,
        "subdivisionId": 0,
        "subdivisionName": "string",
        "subdivisionRank": 0,
        "smallImages": [
          {}
        ],
        "sales24h": 0,
        "imgs": "string",
        "reimgs": "string",
        "detailPics": "string",
        "bizSceneId": 0
      }
    ],
    "pageId": "string",
    "totalNum": 0
  },
  "type": "Toast",
  "redirectUrl": "/error?message=token失效&reDirectTo=/orderList",
  "success": true
}