taobao.baichuan.microservice.iteminfo (百川轻服务商品信息)

通过TOPAPI查询商品,获取商品标题、图片和优惠价格,是否可以在手机淘宝支持,是否支持交易埋点,拼接好带埋点信息的无线扫码链接

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
item_filter_request ItemTraceRequest 可选 获取商品详情对象
  • └ tracer
  • String
  • 可选
  • pid=123&uid=456&t=20160517
  • 埋点信息
  • └ extra
  • String
  • 可选
  • showItem;showPrice
  • 扩展信息,有特殊需求可以用
  • └ item_id
  • Number
  • 可选
  • 44878928007
  • 默认值:0
  • 商品详情
  • └ ext
  • 可选
  • {"test":"1"}
  • 扩展Map字段,用JSON传入,转换为map
  • └ item_url
  • String
  • 可选
  • https://detail.tmall.com/item.htm?id=44878928007&spm=a1z09.2.0.0.ESq8M3&_u=iaja8ln0349
  • 商品详情PC链接
  • └ trace_app_key
  • String
  • 必须
  • 12345
  • appkey

响应参数

名称 类型 示例值 描述
result ItemTraceResponse result 接口返回结果
  • └ error_message
  • String
  • 商品URL参数不合法
  • 错误提示信息
  • └ mini_h5_url_sclick
  • String
  • http://h5.m.taobao.com/trade/detail.html?id=521634259654&ybhpss=cGFnZT15b3VrdV9zdG9yZV93ZWI=
  • 边看边买定制版本详情的淘客版本的h5链接
  • └ reason
  • String
  • 降级H5的原因描述
  • 降级H5的原因描述
  • └ pc_trace_url
  • String
  • https://detail.tmall.com/item.htm?spm=a220o.1000855.1998099587.2.Vw0xdT&id=530594944718&bi_from=tm_comb
  • PC版本的埋点的商品详情链接
  • └ item_type
  • String
  • tmall;alifish
  • 商品类型
  • └ pic_urls
  • String
  • http://img.taobaocdn.com/bao/uploaded/i4/TB1ExrCHFXXXXcXXFXXXXXXXXXX_!!0-item_pic.jpg;http://img.taobaocdn.com/bao/uploaded/i3/53954042/TB24v8zcFXXXXblXXXXXXXXXXXX_!!53954042.jpg
  • 商品图片URL,用";"分割
  • └ pc_trace_url_sclick
  • String
  • http://s.click.taobao.com/t?e=m%3D2%26s%3DVgqRRZfl0NQcQipKwQzePCperVdZeJvi3pzOfSbYqNsYX8TY%2BNEwd61R8AAgeEPt5jVt69nCuKeKQOW2syiWNXn4fq4PRGgn1VDRIrf4q69pevfyEAA8Zs7ngtD9XDUvs8dxGh1xKMPR5F7j6O1iJ%2FbHUAQLZr%2FHllUf46HKv0hI4uczHo6iGnZv1J%2BsaMCbOZ2Ggq4zPdE0g3YufNkZdN8GIWn%2BXjv1latCsKMZ5j2zcQLpDophHLmaoQ5CZH6hV92SJEByqt0V%2FpD7PttXPsMuLI09rL%2FRPaXg%2FKwnH88%3D
  • PC上的淘宝客链接s.click.taobao.com
  • └ item_id
  • Number
  • 532237316399
  • 商品id
  • └ trace_url
  • String
  • https://h5.m.taobao.com/awp/core/detail.htm?id=44878928007&ybhpss=cGlkPTEyMyZ1aWQ9NDU2JnQ9MjAxNjA1MTc=
  • 带上打点信息,可以生成二维码的商品详情URL
  • └ ext
  • Json
  • test
  • 扩展信息
  • └ uniq_detail_url_sclick
  • String
  • http://s.click.taobao.com/t?e=m%3D2%26s%3DVgqRRZfl0NQcQipKwQzePCperVdZeJvi3pzOfSbYqNsYX8TY%2BNEwd61R8AAgeEPt5jVt69nCuKeKQOW2syiWNXn4fq4PRGgn1VDRIrf4q69pevfyEAA8Zs7ngtD9XDUvs8dxGh1xKMPR5F7j6O1iJ%2FbHUAQLZr%2FHllUf46HKv0hI4uczHo6iGnZv1J%2BsaMCbOZ2Ggq4zPdE0g3YufNkZdN8GIWn%2BXjv1latCsKMZ5j2zcQLpDophHLmaoQ5CZH6hV92SJEByqt0V%2FpD7PttXPsMuLI09rL%2FRPaXg%2FKwnH88%3D
  • 个性化地址的淘宝客链接
  • └ o_price
  • String
  • 80.00
  • 商品单价
  • └ category
  • String
  • 女装
  • 类目名称
  • └ title
  • String
  • 裙子夏连衣裙粉红大布娃娃预2016夏季女装新款名媛性感露肩抹胸裙 热卖新品 7.23发货
  • 商品标题
  • └ trace_supported
  • Boolean
  • true
  • 是否支持埋点透传到订单,如果商品详情在手机淘宝用h5打开就标示不能将打点存入订单,但是数量比较少,必须标记出来
  • └ supported
  • Boolean
  • true
  • 是否支持手机淘宝无线端购买,极少数商品不支持无线端购买,只支持PC端购买,这部分商品通过这个字段标示
  • └ error_code
  • String
  • isv.item_url_error
  • 错误码
  • └ mini_h5_url
  • String
  • http://h5.m.taobao.com/trade/detail.html?id=521634259654&ybhpss=cGFnZT15b3VrdV9zdG9yZV93ZWI=
  • 边看边买定制版本详情h5页面链接
  • └ prom_price
  • String
  • 68.00
  • 商品优惠价
  • └ uniq_detail_url
  • String
  • http://h5.m.taobao.com/trip/travel-detail/index/index.html?id=19116691420&hybrid=true&ali_refid=a3_430125_1006%3A1105600270%3AN%3A%E5%A4%A9%E9%97%A8%E7%8B%90%E4%BB%99%E9%97%A8%E7%A5%A8%3Aa64099048d4a2163e7df5b09039bfec4&ali_trackid=1_a64099048d4a2163e7df5b09039bfec4&spm=0.0.0.0.JWigKi
  • 个性化的商品详情h5
  • └ desc_path
  • String
  • i1/530/240/531246539420/TB1XEBZKVXXXXaIXVXX8qtpFXlX
  • descPath

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
BaichuanMicroserviceIteminfoRequest req = new BaichuanMicroserviceIteminfoRequest();
BaichuanMicroserviceIteminfoRequest.ItemTraceRequest obj1 = new BaichuanMicroserviceIteminfoRequest.ItemTraceRequest();
obj1.setTracer("pid=123&uid=456&t=20160517");
obj1.setExtra("showItem;showPrice");
obj1.setItemId(44878928007L);
obj1.setItemUrl("https://detail.tmall.com/item.htm?id=44878928007&spm=a1z09.2.0.0.ESq8M3&_u=iaja8ln0349");
obj1.setTraceAppKey("12345");
req.setItemFilterRequest(obj1);
BaichuanMicroserviceIteminfoResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<baichuan_microservice_iteminfo_response>
    <result>
        <error_message>商品URL参数不合法</error_message>
        <mini_h5_url_sclick>http://h5.m.taobao.com/trade/detail.html?id=521634259654&amp;ybhpss=cGFnZT15b3VrdV9zdG9yZV93ZWI=</mini_h5_url_sclick>
        <reason>降级H5的原因描述</reason>
        <pc_trace_url>https://detail.tmall.com/item.htm?spm=a220o.1000855.1998099587.2.Vw0xdT&amp;id=530594944718&amp;bi_from=tm_comb</pc_trace_url>
        <item_type>tmall;alifish</item_type>
        <pic_urls>http://img.taobaocdn.com/bao/uploaded/i4/TB1ExrCHFXXXXcXXFXXXXXXXXXX_!!0-item_pic.jpg;http://img.taobaocdn.com/bao/uploaded/i3/53954042/TB24v8zcFXXXXblXXXXXXXXXXXX_!!53954042.jpg</pic_urls>
        <pc_trace_url_sclick>http://s.click.taobao.com/t?e=m%3D2%26s%3DVgqRRZfl0NQcQipKwQzePCperVdZeJvi3pzOfSbYqNsYX8TY%2BNEwd61R8AAgeEPt5jVt69nCuKeKQOW2syiWNXn4fq4PRGgn1VDRIrf4q69pevfyEAA8Zs7ngtD9XDUvs8dxGh1xKMPR5F7j6O1iJ%2FbHUAQLZr%2FHllUf46HKv0hI4uczHo6iGnZv1J%2BsaMCbOZ2Ggq4zPdE0g3YufNkZdN8GIWn%2BXjv1latCsKMZ5j2zcQLpDophHLmaoQ5CZH6hV92SJEByqt0V%2FpD7PttXPsMuLI09rL%2FRPaXg%2FKwnH88%3D</pc_trace_url_sclick>
        <item_id>532237316399</item_id>
        <trace_url>https://h5.m.taobao.com/awp/core/detail.htm?id=44878928007&amp;ybhpss=cGlkPTEyMyZ1aWQ9NDU2JnQ9MjAxNjA1MTc=</trace_url>
        <ext>test</ext>
        <uniq_detail_url_sclick>http://s.click.taobao.com/t?e=m%3D2%26s%3DVgqRRZfl0NQcQipKwQzePCperVdZeJvi3pzOfSbYqNsYX8TY%2BNEwd61R8AAgeEPt5jVt69nCuKeKQOW2syiWNXn4fq4PRGgn1VDRIrf4q69pevfyEAA8Zs7ngtD9XDUvs8dxGh1xKMPR5F7j6O1iJ%2FbHUAQLZr%2FHllUf46HKv0hI4uczHo6iGnZv1J%2BsaMCbOZ2Ggq4zPdE0g3YufNkZdN8GIWn%2BXjv1latCsKMZ5j2zcQLpDophHLmaoQ5CZH6hV92SJEByqt0V%2FpD7PttXPsMuLI09rL%2FRPaXg%2FKwnH88%3D</uniq_detail_url_sclick>
        <o_price>80.00</o_price>
        <category>女装</category>
        <title>裙子夏连衣裙粉红大布娃娃预2016夏季女装新款名媛性感露肩抹胸裙 热卖新品 7.23发货</title>
        <trace_supported>true</trace_supported>
        <supported>true</supported>
        <error_code>isv.item_url_error</error_code>
        <mini_h5_url>http://h5.m.taobao.com/trade/detail.html?id=521634259654&amp;ybhpss=cGFnZT15b3VrdV9zdG9yZV93ZWI=</mini_h5_url>
        <prom_price>68.00</prom_price>
        <uniq_detail_url>http://h5.m.taobao.com/trip/travel-detail/index/index.html?id=19116691420&amp;hybrid=true&amp;ali_refid=a3_430125_1006%3A1105600270%3AN%3A%E5%A4%A9%E9%97%A8%E7%8B%90%E4%BB%99%E9%97%A8%E7%A5%A8%3Aa64099048d4a2163e7df5b09039bfec4&amp;ali_trackid=1_a64099048d4a2163e7df5b09039bfec4&amp;spm=0.0.0.0.JWigKi</uniq_detail_url>
        <desc_path>i1/530/240/531246539420/TB1XEBZKVXXXXaIXVXX8qtpFXlX</desc_path>
    </result>
</baichuan_microservice_iteminfo_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.item_url_error 商品URL参数不合法 商品详情一般都会带id的参数,如果没有这个参数,那么会无法itemUrl的值,因此确保商品详情的格式是对的,类似https://detail.tmall.com/item.htm?id=38603063750这样的URL
isv.item_param_error 商品itemId不合法,传入的itemId或者从itemUrl中解析出来的参数不合法。 商品itemId不合法,传入的itemId或者从itemUrl中解析出来的参数不合法。首先检查itemUrl中的id参数是否合法,如果没有传itemUrl,那么就会解析itemId参数格式,那么这个参数是否为正确的商品id。即:检查itemUrl中的id和itemId是否全部不合法

API工具

如何获得此API

FAQ

返回
顶部