微信号:
当前位置:首页 > 资讯文摘 > 网络知识

淘宝SDK开放接口

2016/11/9 10:12:34
SDK开放接口详解
 
 
数据详解
获取方式
使用实例
卖家数据
卖家ID:id
卖家昵称:nick
注册时间:registrationDate
国家:country
省份:province
城市:city
信用:sellerCredit
好评率:sellerGoodRate
通过$_user获取当前的
卖家信息
<?php
$_user->credit;            /*获取卖家信用*/
$_user->goodRate;         /*获取卖家好评率*/
$_user->id;               /*获取卖家ID*/
$_user->nick;             /*获取卖家昵称*/
$_user->registrationDate;  /*获取卖家注册时间*/
$_user->country;         /*获取卖家国家*/
$_user->province;         /*获取卖家省份*/
$_user->city;             /*获取卖家城市*/
?>
店铺数据
店铺 id: id
店铺标题: title
店铺域名: domainName
店铺logo: shopLogo
(新版头部上用到的那种)
店标: logoUrl
(原先老的80x80的)
店铺主营: mainBusiness
收藏人气: collectedCount
宝贝数量: itemCount
店主昵称: ownerNick
店主标识: ownerId
开店时间: startTime
店铺简介: introduction
店铺公告: bulletin
店铺页面链接: shopPageLinks
通过$_shop获取当前的
店铺的信息,其中页面链接
信息通过“shopManager”来获取。
<?php
$_shop->id;              /*获取店铺id*/
$_shop->title;            /*获取店铺名称*/
$_shop->introduction;     /*获取店铺简介*/
$_shop-> bulletin;        /*获取店铺公告*/
$_shop->id;             /*获取店铺ID*/
$_shop->title;           /*获取店铺标题*/
?>
 
<?php                 /*获取首页链接*/
$pageLinks =$shopManager->getShopPageLinks(); foreach($pageLinks as $pageLink){
echo "页面名称".$pageLink->text;
echo "页面链接".$pageLink->href;
echo "页面打开目标".$pageLink->target;
}
?>
店铺类目数据
店铺类目ID: id
店铺类目名称:name
店铺类目图标:iconUrl
父类目ID:parentId
类目所属店铺ID:shopId
店铺类目获取通过ShopCategoryManager获取,ShopCategoryManager的说明如下:
1. 查询所有的店铺类目:queryAll
参数说明:此接口不需要参数,查询当前店铺的所有店铺类目
2. 查询店铺类目的所有子类目:querySubCategories
参数说明:此方法需要传递父类目id
3. 根据店铺类目标识查询店铺类目:queryById
参数说明:此方法需要传递类目id
 
/*查询所有的店铺类目数据*/
<?php
$allShopCategory=$shopCategoryManager->queryAll();
foreach($allShopCategory as $shopCategory){
echo "店铺类目名称是: ".$shopCategory->name;
}
?>
 
/*查询店铺类目的所有子类目*/
<?php
$subCategories=$shopCategoryManager->querySubCategories ($parentId);
foreach($subCategories as $shopCategory){
echo "店铺类目名称是: ".$shopCategory->name;
}
?>
查询店铺类目中的一级类目:此时$parentId=0,
即所有一级类目的父类目的id=0
查询店铺类目中的二级类目:把已经查到一级类目的类目id作为$parentId,查询店铺类目的二级类目
根据店铺类目标识查询店铺类目:
<?php
$shopCategory = $shopCategoryManager-> queryById ($Id);
echo "店铺类目名称是: ".$shopCategory->name;
?>
宝贝数据
宝贝ID :id
宝贝后台类目:
itemCategoryId
宝贝标题:title
宝贝价格:price
宝贝图片地址:picUrl
宝贝销售量:soldCount
宝贝收藏量:
collectedCount
宝贝所属卖家ID: ownerId
宝贝评论数:commentCount (此属性只有商城店铺有,C店铺没有)
宝贝销售量:soldCount
设计师通过ItemManager获取宝贝数据,ItemManager的接口说明如下:
1.根据关键字查询宝贝:queryByKeyword
参数说明:此接口需要传递3个参数,分别为查询关键字,宝贝排序类型,查询数量,其中宝贝排序类型具体见下表,此接口最多返回20个宝贝。
 
2.根据店铺类目ID来查询该类目下的宝贝:
 queryByCategory
参数说明:此接口需要传递3个参数,分别为店铺类目id,宝贝排序类型,查询数量,其中宝贝排序类型具体见下表,此接口最多返回20个宝贝。
 
3.根据指定的宝贝Id查询对应的宝贝数据:queryById
参数说明:此接口需要传递1个参数宝贝ID,如果没有查询到宝贝则返回空
 
4.根据一组宝贝ID查询宝贝,返回的宝贝最大个数为20个:queryByIds
参数说明:此接口需要传递2个参数,分别为待查询的宝贝ID列表以及排序类型,其中宝贝排序类型具体见下表,此接口最多返回20个宝贝。
/*查询关键字为IPad10个宝贝, 按照热销降序排列*/
<?php
$items=$itemManager->queryByKeyword("IPad","hotsell",10);
foreach($items as $item){
echo "宝贝标题: ". $item->title;
echo "宝贝价格: ". $item->price;
}
?>

根据店铺类目ID查询该类目下的宝贝:
<?php
$items=$itemManager->queryByCategory($categoryId,"hotsell",10);
foreach($items as $item ){
echo "宝贝标题:". $item->title;
echo "宝贝价格:". $item->price;
}
?>

根据指定的宝贝Id查询对应的宝贝数据:
<?php
$item = $itemManager-> queryById ($id);
echo "宝贝标题:". $item->title;
echo "宝贝价格:". $item->price;
?>

根据一组宝贝ID查询宝贝:
<?php
$ids=array( 123456,654321);
$items = $itemManager->queryByIds($ids,"hotsell");
foreach($items as $item ){
echo "宝贝标题:". $item->title;
echo "宝贝价格:". $item->price;
}
?>
 
获取不同尺寸的图片
<?php                           /*根据ID查询宝贝*/
$item = $itemManager-> queryById ($id);
echo "宝贝标题:". $item->title;
echo "宝贝价格:". $item->price;
echo “宝贝图片120x120”. $item->getPicUrl(120);
echo “宝贝图片220x220”. $item-> getPicUrl(220);            
?>
友情链接数据
友情链接id:id
友情链接标题:title
用户标识:userId
友情链接URL:url
友情链接数据通过FriendLinkManager接口获取,FriendLinkManager的接口说明如下:
1. 查询当前用户的所有友情链接:queryAllLinks
参数说明:此接口不需要参数,获取当前用户的友情链接
查询当前用户的所有友情链接
<?php
$friendLinks = $friendLinkManager-> queryAllLinks ();
foreach($friendLinks as $friendLink ){
echo "友情链接:". $friendLink ->title;
}
?>
URL数据
宝贝详情页URI
搜索列表页URI
评价页面URI
店铺介绍页面URI
店铺类目URI
收藏店铺URI
旺旺链接URI
1.生成宝贝详情页的URI: detailURI
参数说明:此接口需要传递宝贝对象作为参数
<?php $uriManager->detailURI(); ?>
 
2.生成搜索列表页的URI: searchURI
参数说明:此接口不需要参数
<?php $uriManager->detailURI(); ?>
 
3.生成当前用户的评价页面URI: rateURI
参数说明:此接口不需要参数
<?php $uriManager->rateURI(); ?>
 
4.生成当前店铺介绍页面的URI: shopIntrURI
参数说明:此接口不需要参数
<?php $uriManager->shopIntrURI(); ?>
 
5.生成店铺类目对应的URI:shopCategoryURI
参数说明:此接需要传递店铺类目对象作为参数,当点击生成的uri时,本地sdk会自动跳转到searchList.htm,而此URI最终会渲染searchList.php页面
<?php $uriManager->shopCategoryURI ($shopCategory); ?>
 
6.生成收藏店铺URIfavoriteLink
参数说明:此接口不需要参数,默认获取收藏当前店铺的URI
<?php $uriManager-> favoriteLink(); ?>
 
7.生成旺旺链接URIcontactTag(userNick)
参数说明:此接需要传递用户的旺旺名称
<?php $uriManager-> contactTag ('nick'); ?>
 
生成宝贝详情页的URI
<?php
$itemUrl = $uriManager-> detailURI($item);
?>

生成搜索列表页的URI
<?php
$searchUrl = $uriManager->searchURI();
?>

生成评价页面的URI
<?php
$ rateURI = $uriManager->rateURI ();
?>

生成店铺介绍页面的URI
<?php
$ shopIntroduction = $uriManager->shopIntrURI ();
?>

生成店铺类目URI
<?php
$uriManager->shopCategoryURI($shopCategory)
?>
生成收藏店铺URIfavoriteLink
<?php
         /* 参数说明:此接口不需要参数,默认获取收藏当前店铺的URI */
        echo "生成收藏店铺URI: ".
$uriManager->favoriteLink()
?>
 
生成旺旺链接URI:contactTag(userNick)
<?php
         /* 参数说明:此接需要传递用户的旺旺名称 */
        echo "生成旺旺链接URI: ".
$uriManager->contactTag('nickname')
?>
 
宝贝数据——宝贝排序规则
排序标识
说明
是否默认显示
ceofp
人气宝贝降序排序
_ceofp
人气宝贝升序排序
hotsell
热销宝贝降序排序
_hotsell
热销宝贝升序排序
price
以宝贝价格降序排序
_price
以宝贝价格升序排序
newOn
以最新上架宝贝降序排序
_newOn
以最新上架宝贝升序排序
HotKeep
以热门搜藏降序排序
_HotKeep
以热门搜藏升序排序
time
快结束在后
_time
快结束在前

 

相关新闻: