文档中心 > API类目 > 淘宝商品API

taobao.item.skus.get (根据商品ID列表获取SKU信息)

* 获取多个商品下的所有sku
点击查看更多商品API说明

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
fields String [] 必须 sku_id,num_iid
  • 最大列表长度:20
  • 需返回的字段列表。可选值:Sku结构体中的所有字段;字段之间用“,”分隔。
    num_iids String 必须 1230005 sku所属商品数字id,必选。num_iid个数不能超过40个

    响应参数

    名称 类型 示例值 描述
    skus Sku [] Sku列表
    • └ sku_id
    • Number
    • 123
    • sku的id
    • └ iid
    • String
    • asdf12323adfaa
    • sku所属商品id(注意:iid近期即将废弃,请用num_iid参数)
    • └ num_iid
    • Number
    • 12345
    • sku所属商品数字id
    • └ properties
    • String
    • 1243:1215;5626:5125
    • sku的销售属性组合字符串(颜色,大小,等等,可通过类目API获取某类目下的销售属性),格式是p1:v1;p2:v2
    • └ properties_name
    • String
    • 20000:3275069:品牌:盈讯;1753146:3485013:型号:F908;-1234:-5678:自定义属性1:属性值1
    • sku所对应的销售属性的中文名字串,格式如:pid1:vid1:pid_name1:vid_name1;pid2:vid2:pid_name2:vid_name2……
    • └ quantity
    • Number
    • 3
    • 属于这个sku的商品的数量,
    • └ price
    • String
    • 200.07
    • 属于这个sku的商品的价格 取值范围:0-100000000;精确到2位小数;单位:元。如:200.07,表示:200元7分。
    • └ outer_id
    • String
    • 12345
    • 商家设置的外部id。天猫和集市的卖家,需要登录才能获取到自己的商家编码,不能获取到他人的商家编码。
    • └ created
    • String
    • 2009-11-04 15:24:43
    • sku创建日期 时间格式:yyyy-MM-dd HH:mm:ss
    • └ modified
    • String
    • 2009-11-04 15:24:43
    • sku最后修改日期 时间格式:yyyy-MM-dd HH:mm:ss
    • └ status
    • String
    • normal
    • sku状态。 normal:正常 ;delete:删除
    • └ sku_spec_id
    • Number
    • 123
    • 表示SKu上的产品规格信息
    • └ barcode
    • String
    • 6903244981002
    • 商品级别的条形码

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    ItemSkusGetRequest req = new ItemSkusGetRequest();
    req.setFields("sku_id,num_iid");
    req.setNumIids("1230005");
    ItemSkusGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <item_skus_get_response>
        <skus>
            <sku>
                <sku_id>123</sku_id>
                <iid>asdf12323adfaa</iid>
                <num_iid>12345</num_iid>
                <properties>1243:1215;5626:5125</properties>
                <properties_name>20000:3275069:品牌:盈讯;1753146:3485013:型号:F908;-1234:-5678:自定义属性1:属性值1</properties_name>
                <quantity>3</quantity>
                <price>200.07</price>
                <outer_id>12345</outer_id>
                <created>2009-11-04 15:24:43</created>
                <modified>2009-11-04 15:24:43</modified>
                <status>normal</status>
                <sku_spec_id>123</sku_spec_id>
                <barcode>6903244981002</barcode>
            </sku>
        </skus>
    </item_skus_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.invalid-parameter:numIids-size 参数:numIids-size无效,格式不对、非法值、越界等
    isv.user-not-exist:invalid-nick user 不存在
    isv.invalid-parameter:iids-size 参数:iids-size无效,格式不对、非法值、越界等
    isv.invalid-parameter:numIid 传入的num_iids列表中有不合法的商品数字id出现 Api会对用户传入的numIids进行解析,如果里面有非数字格式的num_iid表示参数不合法会报错。需要在前端做好基本的校验,每个商品数字id都需要是数字类型的。
    isv.missing-parameter:iids-or-numIids 两个特殊可选参数iids和num_iids一个都没有传入 前端做好校验,必须传入num_iid.
    isv.invalid-parameter:iid 非法的iid 淘宝的iid是有基本格式的,必须是32的16进制的数字or字母组成,这个需要前端做好校验。使用num_iid代替iid。
    isp.top-remote-connection-timeout-tmall 系统超时 请稍后重试
    isp.top-remote-method-connection-error-tmall 系统错误 请稍后重试
    isp.service-unavailable 系统错误 偶尔出现重试,频繁出现反馈平台
    isp.service-unavailable-tmall 系统异常 请稍后重试

    API工具

    如何获得此API

    FAQ

    返回
    顶部