全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试

获取当前会话用户出售中的商品列表


接口地址: http://api.vv-tool.com/tool/erps/getonsale


接口介绍: 获取当前用户作为卖家的出售中的商品列表,并能根据传入的搜索条件对出售中的商品列表进行过滤 只能获得商品的部分信息


必须用户授权 : 需要用户的授权,才能拿到被授权的数据


请求方式: POST


返回格式: JSON


接口收费: 联系运营


频率限制: 10 次/秒


请求头参数

参数 类型 必选 示例
Authorization string 授权 access_token Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx

请求参数

名称 类型 必须 示例值 描述
shop_id String true 店铺 ID
fields String true num_iid,title,price 需返回的字段列表。可选值:Item 商品结构体中的以下字段: approve_status,num_iid,title,nick,type,cid,pic_url,num,props,valid_thru,list_time,price,has_discount,has_invoice,has_warranty,has_showcase,modified,delist_time,postage_id,seller_cids,outer_id,sold_quantity ;字段之间用",”分隔。不支持其他字段,如果需要获取其他字段数据,调用 taobao.item.seller.get 获取。
q String false N97 搜索字段。搜索商品的 title。
cid Number false 1512 商品类目 ID。ItemCat 中的 cid 字段。可以通过 taobao.itemcats.get 取到
seller_cids String false 11 卖家店铺内自定义类目 ID。多个之间用",”分隔。可以根据 taobao.sellercats.list.get 获得。(注:目前最多支持 32 个 ID 号传入)
page_no Number false 10 页码。取值范围:大于零的整数。默认值为 1,即默认返回第一页数据。用此接口获取数据时,当翻页获取的条数(page_no*page_size)超过 10 万,为了保护后台搜索引擎,接口将报错。所以请大家尽可能的细化自己的搜索条件,例如根据修改时间分段获取商品
has_discount Boolean false true 是否参与会员折扣。可选值:true,false。默认不过滤该条件
has_showcase Boolean false true 是否橱窗推荐。 可选值:true,false。默认不过滤该条件
order_by String false list_time:desc 排序方式。格式为 column:asc/desc ,column 可选值:list_time(上架时间),delist_time(下架时间),num(商品数量),modified(最近修改时间),sold_quantity(商品销量),;默认上架时间降序(即最新上架排在前面)。如按照上架时间降序排序方式为 list_time:desc
is_taobao Boolean false true 商品是否在淘宝显示
is_ex Boolean false true 商品是否在外部网店显示
page_size Number false 100 每页条数。取值范围:大于零的整数;最大值:200;默认值:40。用此接口获取数据时,当翻页获取的条数(page_no*page_size)超过 2 万,为了保护后台搜索引擎,接口将报错。所以请大家尽可能的细化自己的搜索条件,例如根据修改时间分段获取商品
start_modified Date false 2000-01-01 00:00:00 起始的修改时间
end_modified Date false 2000-01-01 00:00:00 结束的修改时间
is_cspu Boolean false true 是否挂接了达尔文标准产品体系
is_combine Boolean false true 组合商品
auction_type String false a 商品类型:a-拍卖,b-一口价
vvtype int false 普通版 1,不传默认 1,增强版 2,增强版的需要传参 2

请求示例

请求代码示例

cURL请求代码示例


PHP请求代码示例


JAVA请求代码示例

响应参数

名称 类型 示例值 描述
items Item [] 搜索到的商品列表,具体字段根据设定的 fields 决定,不包括 desc 字段
iid String 569a64fce2e98bce187bcbbb4a4d262a 商品 id(注意:iid 近期即将废弃,请用 num_iid 参数)
num_iid Number 1489161932 商品数字 id
title String Google test item 商品标题,不能超过 60 字节
nick String tbtest561 卖家昵称
type String fixed 商品类型(fixed:一口价;auction:拍卖)注:取消团购
cid Number 132443 商品所属的叶子类目 id
seller_cids String 2234445,3344466,446434 商品所属的店铺内卖家自定义类目列表
props String 135255:344454 商品属性 格式:pid:vid;pid:vid
pic_url String http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg 商品主图片地址
num Number 8888 商品数量
valid_thru Number 7 有效期,7 或者 14(默认是 14 天)
list_time Date 2009-10-22 14:22:06 上架时间(格式:yyyy-MM-dd HH:mm:ss)
delist_time Date 2000-01-01 00:00:00 下架时间(格式:yyyy-MM-dd HH:mm:ss)
price Price 5.00 商品价格,格式:5.00;单位:元;精确到:分
has_discount Boolean true 支持会员打折,true/false
has_invoice Boolean true 是否有发票,true/false
has_warranty Boolean true 是否有保修,true/false
has_showcase Boolean true 橱窗推荐,true/false
modified Date 2000-01-01 00:00:00 商品修改时间(格式:yyyy-MM-dd HH:mm:ss)
approve_status String onsale 商品上传后的状态。onsale 出售中,instock 库中
postage_id Number 32 宝贝所属的运费模板 ID,如果没有返回则说明没有使用运费模板
outer_id String 34143554352 商家外部编码(可与商家外部系统对接)
is_virtual Boolean true 虚拟商品的状态字段
is_taobao Boolean true 是否在淘宝显示
is_ex Boolean true 是否在外部网店显示
sold_quantity Number 8888 商品销量
is_cspu Boolean true 是否为达尔文挂接成功了的商品
total_results Number 150 搜索到符合条件的结果总数
withholding_money int 11 该接口扣费金额(点券)

返回数据

{
    "code": 0,
    "msg": "操作成功",
    "msec": 1460,
    "time": 1617273033,
    "data": {
        "withholding_money": 1,
        
    
        }

}

响应代码

代码 代码描述 解决方案
0 成功
100 请求参数错误 检查您的请求参数是否正确
101 请求超时,请重试 检查您的网络情况或者联系客服解决
200 系统错误,请联系客服 检查您的接口地址填写是否正确,其他问题联系客服解决
202 系统错误,请稍后再试 稍后重试,或者联系对接群
203 暂不支持当前接口
204 请求异常:无该接口权限,请前往官网开通正式接口。 前往官网开通该接口权限
204 请求异常:API 调用次数不足,请前往网站兑换次数。 前往官网充值该接口调用次数
302 未授权店铺 根据返回链接进行扫码授权
401 身份凭证无效 在请求头中添加 access_token
614 系统繁忙,请稍后重试 系统繁忙,请稍后重试
614 系统错误 重试
614 获取仓库中商品列表异常,检查 page_no 是否大于 101 ,大于 101 则报该错误。 细化搜索条件,例如根据修改时间分段获取商品
614 查询的 modified 区间错误 start_modified 必需小于等于 end_modified
614 获取数据太多,接口报错 根据搜索条件缩小获取数据量
614 用户信息不存在 确定用户的正确性
614 服务不可用 重试
614 数字超过大小范围 确定数字格式正确性
614 翻页获取的条数(page_no*page_size)超过 2 万,为了保护后台搜索引擎,接口报错 细化搜索条件,例如根据修改时间分段获取商品
614 缺少必要的传入参数 确定入参的正确性
614 user 不存在 传入的 nick 找不到对应的用户记录,尽量通过接口获取 nick 来查询,并且定期更新自己的 nick 数据
614 接口响应超时 重试