taobao.shop.get (获取卖家店铺的基本信息)

获取卖家店铺的基本信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
fields String 必须 sid,cid,title,nick,desc,bulletin,pic_path,created,modified 需返回的字段列表。可选值:Shop 结构中的所有字段;多个字段之间用逗号(,)分隔
nick String 必须 卖家昵称 卖家昵称

响应参数

名称 类型 示例值 描述
shop Shop 店铺信息
  • └ sid
  • Number
  • 44750468
  • 店铺编号
  • └ cid
  • Number
  • 123456
  • 店铺所属的类目编号
  • └ nick
  • String
  • csuky
  • 卖家昵称
  • └ title
  • String
  • 我的店铺
  • 店铺标题
  • └ desc
  • String
  • 我的店铺的描述
  • 店铺描述
  • └ bulletin
  • String
  • 我的店铺的公告
  • 店铺公告
  • └ pic_path
  • String
  • /e2/c0/T1KVXXXhGvt0L1upjX.jpg
  • 店标地址。返回相对路径,可以用"http://logo.taobao.com/shop-logo"来拼接成绝对路径
  • └ created
  • Date
  • 2000-01-01 00:00:00
  • 开店时间。格式:yyyy-MM-dd HH:mm:ss
  • └ modified
  • Date
  • 2000-01-01 00:00:00
  • 最后修改时间。格式:yyyy-MM-dd HH:mm:ss
  • shop_score
  • ShopScore
  • 店铺动态评分信息
  • └ item_score
  • String
  • 60
  • 商品描述评分
  • └ service_score
  • String
  • 100
  • 服务态度评分
  • └ delivery_score
  • String
  • 90
  • 发货速度评分

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
ShopGetRequest req = new ShopGetRequest();
req.setFields("sid,cid,title,nick,desc,bulletin,pic_path,created,modified");
req.setNick("卖家昵称");
ShopGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<shop_get_response>
    <shop>
        <sid>44750468</sid>
        <cid>123456</cid>
        <nick>csuky</nick>
        <title>我的店铺</title>
        <desc>我的店铺的描述</desc>
        <bulletin>我的店铺的公告</bulletin>
        <pic_path>/e2/c0/T1KVXXXhGvt0L1upjX.jpg</pic_path>
        <created>2000-01-01 00:00:00</created>
        <modified>2000-01-01 00:00:00</modified>
        <shop_score>
            <item_score>60</item_score>
            <service_score>100</service_score>
            <delivery_score>90</delivery_score>
        </shop_score>
    </shop>
</shop_get_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>

错误码解释

错误码 错误描述 解决方案
isv.user-not-exist:invalid-nick user 不存在
错误码:40 缺少必要的传入参数 请根据返回的错误信息,将必传参数都填写好
isv.shop-service-error:SHOP_IS_NOT_EXIST 传入的nick存在,但此用户没有店铺
isv.invalid-parameter:user-without-shop 传入的nick存在,但此用户没有店铺

API工具

如何获得此API

FAQ

返回
顶部