淘宝消息服务使用介绍探究.docxVIP

消息服务使用介绍更新时间：2016/03/24?访问次数：229642From淘宝消息服务使用To淘宝消息服务使用常用消息类型说明沙箱消息服务开通消息服务常见问题消息服务是开放平台为提高应用API调用效率而推出的一种主动推送服务（?From淘宝?），推送内容包括（淘宝交易、商品、退款等信息），基于该推送服务，应用获取淘宝数据不需再不停轮询API，仅需在接收到淘宝推送的消息时调用API获取即可，大大提高API调用效率和降低API使用费用。同时还提供消息回流服务（?To淘宝?），应用可将信息回流到淘宝，做商品数源服务等。From淘宝：即淘宝向外推送淘宝（包括天猫）的交易、商品、退款等官方消息。To淘宝：即向淘宝回流消息。那么如何使用消息服务呢？ 请看以下是消息服务 From淘宝 和 To淘宝 两种方式的详细使用说明。From淘宝消息服务使用应用订阅消息进入ISV控制台，在“应用管理-消息服务-订阅消息”页面，选择需要的消息进行订阅，点击相应消息后面的“订阅”即可订阅消息成功，可以在“我的订阅”中查看已经成功订阅的消息。如果需要取消消息的订阅，直接点击 “取消订阅”。点击消息名称可以查看每个消息返回的详细字段信息。注意：如果该消息没有权限，则说明应用未开通相关API调用权限，通过点击“申请权限”，进入申请相应的权限包。另如果需要在沙箱开通消息服务使用，可参照本文的[沙箱消息服务开通]章节给用户开通消息调用taobao.tmc.user.permit接口给用户（即淘宝或天猫商家）开通，可以选择只给用户开通部分消息类型，也可全部开通。具体可看该API 入参说明。备注：给用户开通消息前提是用户已经给应用授权，如未授权，请参考获取用户授权说明。取消用户的消息服务调用taobao.tmc.user.cancel接口。可以通过接口taobao.tmc.user.get获取用户已开通消息，入参必须输入is_valid,topics,modified来判断用户授权消息是否成功消息服务API文档：点击这里查看代码实现接收消息正式环境服务地址：ws:///沙箱环境服务地址：ws:///接收消息，实现方式有两种：?通过SDK接收消息?、?通过API接收消息?，推荐采用SDK接收消息。通过SDK接收消息目前支持JAVA与.NET语言，其它语言建议采用API接收消息。通过SDK接收消息只需要关注业务的处理，不需要操心消息重发、确认、长连接的重连等操作，SDK会自动处理好一切。JAVA接口使用说明123456789101112131415publicinterfaceMessageHandler {?????/**?????* 消息通道客户端收到消息后，会回调该方法处理具体的业务，处理结果可以通过以下两种方式来表述：?????* ul?????* li抛出异常或设置status.fail()表明消息处理失败，需要消息通道服务端重发?????* li不抛出异常，也没有设置status信息，则表明消息处理成功，消息通道服务端不会再投递此消息?????* ?????* @param message 消息内容?????* @param status 处理结果，如果调用status.fail()，消息通道将会择机重发消息；否则，消息通道认为消息处理成功?????* @throws Exception 消息处理失败，消息通道将会择机重发消息?????*/????publicvoidonMessage(Message message, MessageStatus status) throwsException;?}JAVA使用代码示例12345678910111213TmcClient client = newTmcClient(app_key, app_secret, default); // 关于default参考消息分组说明client.setMessageHandler(newMessageHandler() {????publicvoidonMessage(Message message, MessageStatus status) {????????try{????????????System.out.println(message.getContent());????????????System.out.println(message.getTopic());????????} catch(Exception e) {????????????e.printStackTrace();????????????status.fail(); // 消息处理失败回滚，服务端需要重发????????}????}});client.connect(ws://); // 消息