taobao.tbk.uatm.favorites.item.get( 淘宝客-推广者-选品库宝贝信息 )
指定选品库id,获取该选品库的宝贝信息
公共参数
请求参数
名称
类型
必须
示例值
描述
platform
Number
false
1
链接形式:1:PC,2:无线,默认:1
page_size
Number
false
20
页大小,默认20,1~100
adzone_id
Number
true
34567
推广位id,需要在淘宝联盟后台创建;且属于appkey备案的媒体id(siteid),如何获取adzoneid,请参考,http://club.alimama.com/read-htm-tid-6333967.html?spm=0.0.0.0.msZnx5
unid
String
false
3456
自定义输入串,英文和数字组成,长度不能大于12个字符,区分不同的推广渠道
favorites_id
Number
true
10010
选品库的id
page_no
Number
false
2
第几页,默认:1,从1开始计数
fields
String
true
num_iid,title,pict_url,small_images,reserve_price,zk_final_price,user_type,provcity,item_url,seller_id,volume,nick,shop_title,zk_final_price_wap,event_start_time,event_end_time,tk_rate,status,type
需要输出则字段列表,逗号分隔
响应参数
名称
类型
示例值
描述
results
UatmTbkItem []
招商宝贝信息
total_results
Number
100
选品库中的商品总条数
请求示例
JAVA
PHP
.NET
CURL
Python
NodeJS
C/C++
$c = new TopClient; $c->appkey = $appkey; $c->secretKey = $secret; $req = new TbkUatmFavoritesItemGetRequest; $req->setPlatform("1"); $req->setPageSize("20"); $req->setAdzoneId("34567"); $req->setUnid("3456"); $req->setFavoritesId("10010"); $req->setPageNo("2"); $req->setFields("num_iid,title,pict_url,small_images,reserve_price,zk_final_price,user_type,provcity,item_url,seller_id,volume,nick,shop_title,zk_final_price_wap,event_start_time,event_end_time,tk_rate,status,type"); $resp = $c->execute($req);
响应示例
XML
JSON
<tbk_uatm_favorites_item_get_response> <results> <uatm_tbk_item> <num_iid>123</num_iid> <title>连衣裙</title> <pict_url>http://gi4.md.alicdn.com/bao/uploaded/i4/xxx.jpg</pict_url> <small_images> <string>http://gi4.md.alicdn.com/bao/uploaded/i4/xxx.jpg</string> </small_images> <reserve_price>102.00</reserve_price> <zk_final_price>88.00</zk_final_price> <user_type>1</user_type> <provcity>杭州</provcity> <item_url>http://detail.m.tmall.com/item.htm?id=xxx</item_url> <click_url>http://s.click.taobao.com/e=xxx</click_url> <nick>demo</nick> <seller_id>123</seller_id> <volume>1</volume> <tk_rate>20.00</tk_rate> <zk_final_price_wap>98.00</zk_final_price_wap> <shop_title></shop_title> <event_start_time>2015-01-01 00:00:00</event_start_time> <event_end_time>2015-01-01 00:00:00</event_end_time> <type>1</type> <status>1</status> <category>1</category> <coupon_click_url>https://uland.taobao.com/coupon/edetail?e=xxx</coupon_click_url> <coupon_end_time>2016-09-26</coupon_end_time> <coupon_info>满16元减10元</coupon_info> <coupon_start_time>2016-09-25</coupon_start_time> <coupon_total_count>8000</coupon_total_count> <coupon_remain_count>6859</coupon_remain_count> </uatm_tbk_item> </results> <total_results>100</total_results></tbk_uatm_favorites_item_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>
错误码解释
错误码 | 错误消息 | 解决方案 |
---|---|---|
isp.tbkapi-service-unavailable | 淘宝客API服务不可用 | 请稍后尝试 |
isv.invalid-parameter:adzone_id | adzone_id不正确 | 请填写与member_id和site_id匹配的adzone_id |
isv.invalid-parameter:favorites_id | 参数填写错误 | 请填写正确参数值重试 |
isv.invalid-parameter:unid | 参数填写错误 | 请填写正确参数值重试 |
isp.tbkapi-favoriteid-error | 服务异常 | 请稍后重试 |
如何获得此API
拥有此API的权限组 | 可获得/可申请此API权限组的应用类型 |
---|---|
淘宝客【推广者】选品库 | 联盟合作网站 |