SDK是通过php方式对外提供接口的,详细的接口信息,请阅读SDK安装目录下的htdocs/dcsdk_functions.php,提供了全局变量、函数和相关的接口。
卖家数据
数据详解
• 卖家ID:id
• 卖家昵称:nick
• 注册时间: registrationDate
• 国家 : country
• 省份 : province
• 城市 : city
• 信用 : sellerCredit
• 好评率:sellerGoodRate
测试想sss
获取方式
设计师在模板上通过$_user获取当前的卖家信息。
使用实例
<?php
/*获取卖家信用*/
$_user->credit;
/*获取卖家好评率*/
$_user->goodRate;
/*获取卖家ID*/
$_user->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”来获取。
此处有细微变动,请设计师认真阅读:
/*获取首页链接*/
$shopManager里面,不再有getShopPageLinks方法
使用实例
<?php
/*获取店铺id*/
$_shop->id;
/*获取店铺名称*/
$_shop->title;
/*获取店铺简介*/
$_shop->introduction;
/*获取店铺公告*/
$_shop-> bulletin;
/*获取店铺ID*/
$_shop->id;
/*获取店铺标题*/
$_shop->title;
?>
<?php
/*获取首页链接*/
<--!$shopManager里面不再有getShopPageLinks方法-->
$pageLinks =$shopManager->getShopPageLinks();
foreach($pageLinks as $pageLink){
echo "页面名称".$pageLink->text;
echo "页面链接".$pageLink->href;
echo "页面打开目标".$pageLink->target;
echo "页面是否高亮".$pageLink->highLight;
}
?>
店铺类目数据
数据详解
店铺类目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个宝贝。
宝贝排序规则:
排序标识 |
说明 |
是否默认显示 |
ceofp |
人气宝贝升序排序 |
是 |
_ceofp |
人气宝贝降序排序 |
否 |
hotsell |
热销宝贝升序排序 |
否 |
_hotsell |
热销宝贝降序排序 |
否 |
price |
以宝贝价格升序排序 |
否 |
_price |
以宝贝价格降序排序 |
否 |
newOn |
以最新上架宝贝升序排序 |
否 |
_newOn |
以最新上架宝贝降序排序 |
否 |
HotKeep |
以热门搜藏升序排序 |
否 |
_HotKeep |
以热门搜藏降序排序 |
否 |
使用实例
根据关键字查询宝贝:
<?php
/*查询关键字为IPad的10个宝贝, 按照热销降序排列*/
$items = $itemManager-> queryByKeyword ("IPad","hotsell",10);
foreach($items as $item){
echo "宝贝标题: ". $item->title;
echo "宝贝价格: ". $item->price;
}
?>
根据店铺类目ID查询该类目下的宝贝:
<?php
/*根据类目ID查询10个宝贝,按照热销降序排列*/
$items = $itemManager-> queryByCategory ($categoryId,"hotsell",10);
foreach($items as $item ){
echo "宝贝标题:". $item->title;
echo "宝贝价格:". $item->price;
}
?>
根据指定的宝贝Id查询对应的宝贝数据:
<?php
/*根据ID查询宝贝*/
$item = $itemManager-> queryById ($id);
echo "宝贝标题:". $item->title;
echo "宝贝价格:". $item->price;
?>
根据一组宝贝ID查询宝贝:
<?php
/*根据ID列表查询宝贝*/
$ids=array( 123456,654321);
$items = $itemManager->queryByIds($ids,"hotsell");
foreach($items as $item ){
echo "宝贝标题:". $item->title;
echo "宝贝价格:". $item->price;
}
?>
宝贝图片大小
现在支持的图片大小有:40x40、60x60、80x80、100x100、120x120、160x160、220x220、310x310、620x10000
获取不同尺寸的图片
<?php
/*根据ID查询宝贝*/
$item = $itemManager-> queryById ($id);
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($item);?>
2. 生成搜索列表页的URI: searchURI
参数说明:此接口不需要参数
<?php$uriManager->searchURI();?>
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. 生成收藏店铺URI:favoriteLink
参数说明:此接口不需要参数,默认获取收藏当前店铺的URI
<?php$uriManager-> favoriteLink();?>
7. 生成旺旺链接URI:contactTag(userNick)
参数说明:此接需要传递用户的旺旺名称
<?php$uriManager-> contactTag ('nick');?>
新增子旺旺的数据接口
旺旺客服标签
$uriManager->supportTag 方法和参数详细介绍
提供了四种调用模式,
单个参数模式,参数为客户旺旺的ID.
<?php
echo $uriManager->supportTag("客服旺旺ID号");
?>
两个参数模式,参数为: 客户旺旺ID,旺旺点灯图片提示消息(等价于 <img alt="提示消息">)
<?php
echo $uriManager->supportTag("客服旺旺ID号","请点击直接访问");
?>
三个参数模式,参数为: 客户旺旺ID,旺旺点灯图片提示消息(等价于 <img alt="提示消息">),旺旺点灯的图片样式(1为默认新样式,二为老样式)
<?php
echo $uriManager->supportTag("客服旺旺ID号","请点击直接访问",1);
?>
四个参数模式,参数为: 客户旺旺ID,旺旺点灯图片提示消息(等价于 <img alt="提示消息">),旺旺点灯的图片样式(1为默认新样式,二为老样式),E客服分流.
<?php
echo $uriManager->supportTag("客服旺旺ID号","请点击直接访问",1,false);
?>
相关知识请参考: http://wangwang.taobao.com/2010_fp/world.php
使用实例
生成宝贝详情页的URI:
<?php
/*生成宝贝详情页的URI */
$itemUrl = $uriManager-> detailURI($item);
?>
生成搜索列表页的URI:
<?php
/*生成搜索列表页的URI */
$searchUrl = $uriManager->searchURI();
?>
生成评价页面的URI:
<?php
/*生成评价页面的URI */
$ rateURI = $uriManager->rateURI ();
?>
生成店铺介绍页面的URI:
<?php
/*生成店铺介绍页面的URI */
$ shopIntroduction = $uriManager->shopIntrURI ();
?>
生成店铺类目URI::
<?php
/*生成店铺类目URI*/
$uriManager->shopCategoryURI($shopCategory)
?>
生成收藏店铺URI:favoriteLink
<?php
/* 参数说明:此接口不需要参数,默认获取收藏当前店铺的URI */
echo "生成收藏店铺URI: ".$uriManager->favoriteLink()
?>
生成旺旺链接URI:contactTag(userNick)
<?php
/* 参数说明:此接需要传递用户的旺旺名称 */
echo "生成旺旺链接URI: ".$uriManager->contactTag('nickname')
?>
分享到:
相关推荐
淘宝SDK开放接口详解,淘宝SDK开放接口详解
ECShop模板开发详解.pdf ECShop模板开发详解.pdf ECShop模板开发详解.pdf
淘宝装修、_SDK高级模板开发流程详解、SDK开发高手必备档案.pdf
整理一些PHP的SDK开放接口详解,都是常用的,而且方便查看和学习。
Smarty 模板开发详解.pdfSmarty 模板开发详解.pdfSmarty 模板开发详解.pdfSmarty 模板开发详解.pdfSmarty 模板开发详解.pdfSmarty 模板开发详解.pdfSmarty 模板开发详解.pdfSmarty 模板开发详解.pdfSmarty 模板开发...
支付接口开发详解,设计支付宝 及 网银支付模式 等方式的二次开发
dvi接口详解dvi接口详解dvi接口详解
Android推荐书籍------Android 底层接口与驱动开发技术详解
xfire开发Web Service接口详解,里面包含图片和文字,适合初学web service的
淘宝装修、_SDK高级模板开发流程详解、SDK开发高手必备档案
二、只使用taobao.trades.sold.get同步订单,此接口是按照订单创建时间查询的,一个订单创建后何时被修改(付款、发货、确认收货)是不确定的,所以采用这种方案无法确定该同步哪个时段内的订单,除非你每次都同步3...
本文档为S32K系列 MCU应用开发 详解 带完整目录高清版
CORBA接口开发详解
详解EBS接口开发之WIP模块接口.docx
本资料是 范文庆 周彬彬 安靖编著,人民邮电出版社出版的windows api 开发详解 函数,接口,编程实例一书的光盘资料,希望有兴趣的人好好珍惜!
Android 底层接口与驱动开发技术详解 相关资料
完全手册单片机C语言开发详解系列之输入接口实战—键盘PPT学习教案.pptx
Android底层接口和驱动开发技术详解-下载代码