文档中心 > API类目 > 闲鱼循环商店-前台

alibaba.idle.cycleshop.store.savegoods.toupsale (闲鱼循环商店-门店货品上架售卖|修改售卖信息)

闲鱼循环商店-门店货品上架售卖|修改售卖信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param CycleShopSaveGoodsToUpSaleTopCmd 必须 请求参数
  • └ goods_id
  • Number
  • 必须
  • 3241236524353245
  • 闲鱼货品Id
  • └ title
  • String
  • 可选
  • iphone13手机
  • 闲鱼商品标题,线上售卖时必选
  • └ desc
  • String
  • 可选
  • 红色,9成新
  • 闲鱼商品描述,线上售卖时必选
  • img_list
  • CycleShopImageTopVO []
  • 可选
  • [{'id':23452352345,'url':'http://kkk.ipg','wide':68,'height':168}]
  • 闲鱼商品图片列表,线上售卖时必选
  • └ id
  • Number
  • 可选
  • 234543565756
  • 图片id
  • └ url
  • String
  • 可选
  • http://kkk.ipg
  • 图片url
  • └ wide
  • Number
  • 可选
  • 68
  • 宽度
  • └ height
  • Number
  • 可选
  • 168
  • 高度
  • pv_list
  • CycleShopPropertyTopVO []
  • 可选
  • [{'property_id':'345234','property_name':'颜色','value_id':'6746543','value_name':'红色'}]
  • 闲鱼商品属性列表,线上售卖时必选
  • └ property_id
  • String
  • 可选
  • 345234
  • 属性Id
  • └ property_name
  • String
  • 可选
  • 颜色
  • 属性名称
  • └ value_id
  • String
  • 可选
  • 6746543
  • 值Id
  • └ value_name
  • String
  • 可选
  • 红色
  • 值名称
  • └ category
  • String
  • 可选
  • 126862528
  • 商品叶子类目id,线上售卖时必选
  • └ division_id
  • Number
  • 可选
  • 330110
  • 最小行政单位code,若是地区级别,则为地区级别的id;否则为城市级别的id,线上售卖时必选
  • └ longitude
  • BigDecimal
  • 可选
  • 120.345
  • 商品所在地经度,线上售卖时必选
  • └ latitude
  • BigDecimal
  • 可选
  • 89.345
  • 商品所在地纬度,线上售卖时必选
  • └ price
  • Number
  • 必须
  • 8900
  • 实际售价
  • └ sale_way
  • String
  • 必须
  • Online
  • 售卖方式【Online:仅线上,Offline:仅线下,Both:线上+线下】
  • book_data
  • CycleShopBookTopDO
  • 可选
  • 图书信息(图书类目线上售卖时必选)
  • └ barcode
  • String
  • 可选
  • 123452353asdfsa342
  • 图书ISBN码
  • └ barcode_name
  • String
  • 可选
  • 计算机科学实践
  • 图书ISBN码对应的书名
  • └ original_price
  • Number
  • 可选
  • 500000
  • 商品原价,划线价,单位分
  • └ is_brand_new
  • Boolean
  • 可选
  • true
  • 商品是否全新(全新商品上会展示标)

响应参数

名称 类型 示例值 描述
result CommonResult 返回结果
  • └ success
  • Boolean
  • true
  • 是否成功
  • └ err_code
  • String
  • PARAM_ERROR
  • 错误码
  • └ err_msg
  • String
  • 参数不合法
  • 错误描述
  • data
  • CycleShopSaveGoodsToUpSaleTopVO
  • 成功时返回数据
  • └ goods_id
  • Number
  • 1235423434
  • 闲鱼货品id
  • └ item_id
  • Number
  • 435243252342
  • 闲鱼商品Id(线上售卖时会返回)

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaIdleCycleshopStoreSavegoodsToupsaleRequest req = new AlibabaIdleCycleshopStoreSavegoodsToupsaleRequest();
AlibabaIdleCycleshopStoreSavegoodsToupsaleRequest.CycleShopSaveGoodsToUpSaleTopCmd obj1 = new AlibabaIdleCycleshopStoreSavegoodsToupsaleRequest.CycleShopSaveGoodsToUpSaleTopCmd();
obj1.setGoodsId(3241236524353245L);
obj1.setTitle("iphone13手机");
obj1.setDesc("红色,9成新");
List<AlibabaIdleCycleshopStoreSavegoodsToupsaleRequest.CycleShopImageTopVO> list3 = new ArrayList<AlibabaIdleCycleshopStoreSavegoodsToupsaleRequest.CycleShopImageTopVO>();
AlibabaIdleCycleshopStoreSavegoodsToupsaleRequest.CycleShopImageTopVO obj4 = new AlibabaIdleCycleshopStoreSavegoodsToupsaleRequest.CycleShopImageTopVO();
list3.add(obj4);
obj4.setId(234543565756L);
obj4.setUrl("http://kkk.ipg");
obj4.setWide(68L);
obj4.setHeight(168L);
obj1.setImgList(list3);
List<AlibabaIdleCycleshopStoreSavegoodsToupsaleRequest.CycleShopPropertyTopVO> list6 = new ArrayList<AlibabaIdleCycleshopStoreSavegoodsToupsaleRequest.CycleShopPropertyTopVO>();
AlibabaIdleCycleshopStoreSavegoodsToupsaleRequest.CycleShopPropertyTopVO obj7 = new AlibabaIdleCycleshopStoreSavegoodsToupsaleRequest.CycleShopPropertyTopVO();
list6.add(obj7);
obj7.setPropertyId("345234");
obj7.setPropertyName("颜色");
obj7.setValueId("6746543");
obj7.setValueName("红色");
obj1.setPvList(list6);
obj1.setCategory("126862528");
obj1.setDivisionId(330110L);
obj1.setLongitude("120.345");
obj1.setLatitude("89.345");
obj1.setPrice(8900L);
obj1.setSaleWay("Online");
AlibabaIdleCycleshopStoreSavegoodsToupsaleRequest.CycleShopBookTopDO obj8 = new AlibabaIdleCycleshopStoreSavegoodsToupsaleRequest.CycleShopBookTopDO();
obj8.setBarcode("123452353asdfsa342");
obj8.setBarcodeName("计算机科学实践");
obj1.setBookData(obj8);
obj1.setOriginalPrice(500000L);
obj1.setIsBrandNew(true);
req.setParam(obj1);
AlibabaIdleCycleshopStoreSavegoodsToupsaleResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_idle_cycleshop_store_savegoods_toupsale_response>
    <result>
        <success>true</success>
        <err_code>PARAM_ERROR</err_code>
        <err_msg>参数不合法</err_msg>
        <data>
            <goods_id>1235423434</goods_id>
            <item_id>435243252342</item_id>
        </data>
    </result>
</alibaba_idle_cycleshop_store_savegoods_toupsale_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部