开发文档
国际站消息API 接入指南
更新时间：2020/10/11
访问次数：4775
国际站消息API 接入指南
1. 文档
icbu_trade_OrderNotify（国际站订单变更消息）
https://open.taobao.com/tmc.htm?docId=1754&docType=9
开放平台消息服务文档
https://open.taobao.com/doc.htm?spm=a219a.7386653.0.0.eed2669asPNzkA&docId=101663&docType=1
2. ISV 订阅消息
https://console.open.taobao.com/
3.申请消息服务接口权限
4. 接入
- 给你们ISV自己的用户开通消息
调用taobao.tmc.user.permit接口给用户（即淘宝或天猫商家）开通，可以选择只给用户开通部分消息类型，也可全部开通。具体可看该API 入参说明。
备注：
- 给用户开通消息前提是用户已经给应用授权，如未授权，请参考获取用户授权说明。
- 取消用户的消息服务调用taobao.tmc.user.cancel接口。
- 如果用户对appkey授权过期超过15天，后续用户开通需要重新调用taobao.tmc.user.permit。
- 可以通过接口taobao.tmc.user.get获取用户已开通消息，入参必须输入is_valid,topics,modified来判断用户授权消息是否成功
- 消息服务API文档：点击这里查看
5. 代码实现接收消息
java 代码参考如下，其他 参考“开放平台消息服务文档”
TmcClient client = new TmcClient(APP_KEY, APP_SECRET,
"default"); // 关于default参考消息分组说明
client.setMessageHandler(new MessageHandler() {
public void onMessage(Message message, MessageStatus status) {
try {
if (!"icbu_trade_OrderNotify".equals(message.getTopic())) {
return;
}
System.out.println("ye is ok " + message.getTopic());
System.out.println(message.getContent());
} catch (Exception e) {
e.printStackTrace();
status.fail(); // 消息处理失败回滚，服务端需要重发
// 重试注意：不是所有的异常都需要系统重试。
// 对于字段不全、主键冲突问题，导致写DB异常，不可重试，否则消息会一直重发
// 对于，由于网络问题，权限问题导致的失败，可重试。
// 重试时间 5分钟不等，不要滥用，否则会引起雪崩
}
}
});
client.connect("ws://mc.api.taobao.com");
Thread.sleep(1000000000);
