首页 > 开发文档 > 消息推送服务

消息推送服务

宙斯消息推送服务

    消息推送是宙斯开放平台为提高应用API调用效率而推出的一种主动推送服务,推送内容包括(京东订单、商品、退款等信息),基于该推送服务,应用获取京东数据不需再不停轮询API,仅需在接收到京东推送的消息时调用API获取即可,大大提高API调用效率和降低API使用费用。

一. 条件与准备

1.     条件:

a)      正式数据仅支持内网通知与推送,所以需要入鼎

b)      目前能够支持华北机房

c)      Java语言可使用SDK,非Java需要使用API来接收消息

2.      准备:

a)    京东云账号(需要设置账号的Access Key),用来接收消息

b)    至少一个商家Pin对订阅消息的Appkey授权,JOS会根据此Appkey生成Topic,并向该Topic推送此商家的消息

c)    消息推送Demo示例,请参见https://docs.jdcloud.com/cn/message-queue/demo

d)    请在”文档中心“--->"常用文档”--->"消息体文档“获取消息体信息


二. 使用流程

1.注册京东云账户,创建账户秘钥

使用京东账户登录京东云 https://www.jdcloud.com,选择账户管理

点击左侧导航栏AccessKey管理

点击创建AccessKey

注意:请保存好已经创建的京东云Access Key IDAccess Key Secret,在后续的宙斯控制台消息配置中将会用到;

 

2.在宙斯控制台(https://dev.jd.com)根据业务需求创建对应的应用类型

通过审核后选择对应的应用卡片点击应用管理

查看该应用的Appkey

宙斯消息推送目前为邀请制公测阶段,仅对部分开发者进行开放,预计在7月中询全量开放,全量开放后,开发者可以在宙斯控制台看到消息推送的功能入口;

3.应用订阅消息

在宙斯控制台应用管理界面选择需要订阅消息推送的应用卡片并点击应用管理,在左侧导航栏选择消息服务->订阅消息

点击需要查看的消息主题的消息体按钮可以查看该主题的消息体字段信息

选择需要订阅的消息主题后点击订阅,此处需要填入京东云Access Key IDAccess Key Secret(查找方式请查阅本章第1部分内容),系统会校验账户关联与信息准确性,请开发者务必填写准确

4.管理我订阅的消息

点击我的订阅进入消息管理界面,订阅状态包括订阅成功、订阅失败、审核中三种;订阅成功的消息体可以取消订阅,订阅失败的消息可以重新订阅,审核中的消息体审核完成后状态会变更为订阅成功或者订阅失败

注意:如果该消息没有权限,则说明应用未开通相关API调用权限,可以在应用内查看并申请相应的权限包。

5.查看消息体文档

请在”文档中心“--->"常用文档”--->"消息体文档“获取文档信息