使用高级电商能力，能实现复杂的电商导购场景，包括通过API获取淘宝商品数据，通过消息通知获取商品变更信息和订单消息。使用前需要先确保应用已经申请到高级电商能力，申请流程：点击查看。

1、淘宝商品数据获取

对开发者商品获取，自有的方式是线上找商品，普遍成本比较高。而百川提供两种方式，一种是百川选品平台，另一种是服务端API方式，方便开发者快捷的找到想要的淘宝商品。服务端API调用需要在TAE容器中使用，需要创建TAE容器，并把程序部署到容器中，TAE具体使用：点击查看 。

1.1 选品平台

商品中心是基于TAE开放平台向开发者用户提供全方位商品数据开放服务的产品。同时也是百川计划中非常重要的一环，在商品中心我们对用户开放了自定义选品功能、自定义商品池管理、商品分组管理、商品变更消息服务、商品分组读取接口等功能。 具体使用说明：点击查看 。 

1.2 通过API获取商品数据

API功能介绍

API名称	使用场景	申请流程
taobao.atb.items.get 淘客商品搜索	提供淘宝客商品批量搜索功能，商品数据的获取主要通过这个接口完成。 需要单独申请API权限。	无线开放百川淘客包 在应用后台证书管理中进行申请，申请流程：点击查看 。
taobao.atb.items.coupon.get 淘客折扣商品搜索
taobao.atb.items.relate.get   淘客商品关联推荐
taobao.tae.items.list 百川商品列表接口	批量传入商品明文ID或者混淆商品ID，获取商品信息和商品混淆ID。可用于商品列表页。	高级电商能力 在应用后台证书管理中进行申请，申请流程：点击查看 。
taobao.tae.item.detail.get  百川商品详细获取	完善商品导购页使用，能返回较完整的商品信息，宝贝描述、sku、价格、主图、库存、卖家、物流、评价、门店等商品详情页需要的信息。	高级电商能力  在应用后台证书管理中进行申请，申请流程：点击查看 。

注意：百川混淆商品ID字段open_iid是由商品明文ID+APPKEY一起加密生成的，每个应用open_iid是唯一的，且只能对应appkey的应用中使用。常见问题 

在百川业务中，商品数据标识都使用混淆的商品ID（open_iid，字符串型）。对于直接通过淘宝页面上搜索的商品明文ID或非其他渠道获取的商品明文ID，需要使用 taobao.tae.items.list  商品列表接口，把明文ID（num_iid）转成混淆商品ID（open_iid） 。  

API调用说明

接口调用说明：点击查看

API SDK已经集成了接口签名方法，只需要引入对应于的类文件，就可以直接调用接口了，下载说明：点击查看 。

以taobao.tae.item.detail.get接口为例的代码示例：

JAVA

	TaobaoClient client=new DefaultTaobaoClient(url, appkey, secret); 
	TaeItemDetailGetRequest req=new TaeItemDetailGetRequest(); 
	req.setId("AAEkwBGKAAXszj-DOJ-KKVll"); 
	req.setFields("itemInfo,priceInfo,skuInfo,stockInfo,rateInfo,descInfo,sellerInfo,mobileDescInfo,deliveryInfo,storeInfo"); 
	TaeItemDetailGetResponse response = client.execute(req);

PHP

	$c = new TopClient; 
	$c->appkey = appkey; 
	$c->secretKey = secret; 
	$req = new TaeItemDetailGetRequest; 
	$req->setId("AAEkwBGKAAXszj-DOJ-KKVll"); 
	$req->setFields("itemInfo,priceInfo,skuInfo,stockInfo,rateInfo,descInfo,sellerInfo,mobileDescInfo,deliveryInfo,storeInfo"); 
	$resp = $c->execute($req);

服务端说明

需要把具体获取商品数据的代码上传到TAE服务端，因为百川业务限制所有API请求都必须从TAE环境内发起请求。

建议直接参考demo的代码和使用说明：点击查看。

2、使用open_iid［混淆的商品ID］唤起官方商品详情页

对百川的open_iid，提供了专门方法唤起淘宝商品详情页：

唤起官方商品详情页， android版本查看    iOS版本击查看 。

唤起官方商品详情页，带淘客结算功能， android版本查看    iOS版本击查看 。

这两个方法中需要传入的商品ID参数，就是API获取的商品模糊ID(open_iid)。

使用带淘客结算功能唤起官方商品详情页，佣金结算是使用阿里妈妈的PID参数，在接口调用时需要传入与appkey对应的PID才会结算佣金 ，并且必须要淘宝客API权限申请成功才能使用。

3.消息通知

3.1 消息类型

我们提供了消息通知功能，在百川SDK中所有创建的订单消息，都是能通过消息通知功能获取。此功能可以帮助引导成交应用的开发者做售后服务，个性化营销推荐等，同时也可以让消费者在对应APP渠道查看自己的订单列表。 另外还提供了商品信息更新消息通知，主要用于当商品信息发生变更时，通过消息通知给订阅的开发者，方便开发者及时下线过期和无效商品，优化客户端体验。具体文档：点击查看

客户端SDK还支持定制 isvcode入参(不多于50个字符，支持英文字符&数字，不要使用特殊符号)，会透传至交易流程，在交易消息通知中，能获取到这个字段，用于更定制化的订单跟踪。点击查看

 

消息类型（使用前需订阅此消息）

 taobao_tae_BaichuanTradeCreated 创建订单消息              

 taobao_tae_BaichuanTradeSuccess 交易成功消息              

 taobao_tae_BaichuanTradeRefundSuccess  退款成功          

 taobao_tae_BaichuanTradePaidDone    付款成功

taobao_tae_BaichuanAuctionChange  商品更新通知服务          

3.2 使用方法

调用API方式来获取相应的消息，如下API所示：

taobao.iselect.tae.itempool.change  添加需要监控的商品 ，把需要监控的商品添加到消息库中，才能接受到相关商品变更消息。

taobao.tmc.messages.consume   消费消息。

主要用来获取消息（消息消费后，指针自动后移，下次调用自动获取到未消费过的消息，但是消费确认后的消息无法再次获取）

taobao.tmc.messages.confirm    确认消息。

获取消息后，如果不确认，消息服务会选择时机重发，重发次数由消息服务控制，如果消息7天内都没有被确认将会被删除

主要包含字段:buyer_id、paid_fee、order_id(交易订单号)、order_status、auction_id(商品混淆ID)、auction_title、auction_pict_url、topic

具体文档：点击查看 

4.电子凭证场景

 SDK支持电子凭证类商品购买下单， taobao.tae.item.detail.get 可以获取门店的详细位置信息，用于商品详情页展示。

  

消费者购买成功以后，可以通过接口唤起电子凭证页面，用于实体店核销。android参见 ios参见

以上所有都只是场景实现的建议方式，开发者可以根据实际业务需要来设计各个流程。

5.数据交互流程图

注意：使用百川淘客API、商品API，获取淘宝相关的数据，是需要把服务端程序和数据库都部署托管在TAE中。这些获取数据的API也只有在TAE容器中调用。

 

群号：1488705339

 

FAQ

关于此文档暂时还没有FAQ