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

消息服务使用介绍 更新时间：2016/03/24?访问次数：229642 HYPERLINK /doc2/detail.htm?spm=a219a.7629140.0.0.RztEFatreeId=1articleId=101663docType=1 \l s0 \o From淘宝消息服务使用 From淘宝消息服务使用 HYPERLINK /doc2/detail.htm?spm=a219a.7629140.0.0.RztEFatreeId=1articleId=101663docType=1 \l s1 \o To淘宝消息服务使用 To淘宝消息服务使用 HYPERLINK /doc2/detail.htm?spm=a219a.7629140.0.0.RztEFatreeId=1articleId=101663docType=1 \l s2 \o 常用消息类型说明 常用消息类型说明 HYPERLINK /doc2/detail.htm?spm=a219a.7629140.0.0.RztEFatreeId=1articleId=101663docType=1 \l s3 \o 沙箱消息服务开通 沙箱消息服务开通 HYPERLINK /doc2/detail.htm?spm=a219a.7629140.0.0.RztEFatreeId=1articleId=101663docType=1 \l s4 \o 消息服务常见问题 消息服务常见问题 消息服务是开放平台为提高应用API调用效率而推出的一种主动推送服务（?From淘宝?），推送内容包括（淘宝交易、商品、退款等信息），基于该推送服务，应用获取淘宝数据不需再不停轮询API，仅需在接收到淘宝推送的消息时调用API获取即可，大大提高API调用效率和降低API使用费用。同时还提供消息回流服务（?To淘宝?），应用可将信息回流到淘宝，做商品数源服务等。 From淘宝：即淘宝向外推送淘宝（包括天猫）的交易、商品、退款等官方消息。 To淘宝：即向淘宝回流消息。 那么如何使用消息服务呢？ 请看以下是消息服务 From淘宝 和 To淘宝 两种方式的详细使用说明。 From淘宝消息服务使用 应用订阅消息 进入 HYPERLINK / ISV控制台，在“应用管理-消息服务-订阅消息”页面，选择需要的消息进行订阅，点击相应消息后面的“订阅”即可 订阅消息成功，可以在“我的订阅”中查看已经成功订阅的消息。如果需要取消消息的订阅，直接点击 “取消订阅”。点击消息名称可以查看每个消息返回的详细字段信息。 注意：如果该消息没有权限，则说明应用未开通相关API调用权限，通过点击“申请权限”，进入申请相应的权限包。另如果需要在沙箱开通消息服务使用，可参照本文的[沙箱消息服务开通]章节 给用户开通消息 调用 HYPERLINK /doc2/apiDetail?apiId=21990 taobao.tmc.user.permit接口给用户（即淘宝或天猫商家）开通，可以选择只给用户开通部分消息类型，也可全部开通。具体可看该API 入参说明。 备注： 给用户开通消息前提是用户已经给应用授权，如未授权，请参考 HYPERLINK /doc2/detail.htm?treeId=49articleId=102635docType=1 获取用户授权说明。 取消用户的消息服务调用taobao.tmc.user.cancel接口。 可以通过接口taobao.tmc.user.get获取用户已开通消息，入参必须输入is_valid,topics,modified来判断用户授权消息是否成功 消息服务API文档： HYPERLINK /doc2/apiDetail?apiId=21990 点击这里查看 代码实现接收消息 正式环境服务地址：ws:///沙箱环境服务地址：ws:///接收消息，实现方式有两种：?通过SDK接收消息?、?通过API接收消息?，推荐采用SDK接收消息。 通过SDK接收消息 目前支持JAVA与.NET语言，其它语言建议采用API接收消息。通过SDK接收消息只需要关注业务的处理，不需要操心消息重发、确认、长连接的重连等操作，SDK会自动处理好一切。 JAVA接口使用说明 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 public interface MessageHandler { ? ????/** ?????* 消息通道客户端收到消息后，会回调该方法处理具体的业务，处理结果可以通过以下两种方式来表述： ?????* ul ?????* li抛出异常或设置status.fail()表明消息处理失败，需要消息通道服务端重发 ?????* li不抛出异常，也没有设置status信