概述

使用消息订阅功能时，需要开发消息接收接口。开放平台通过HTTP协议POST方式调用消息接收接口，并且请求头中的Content-Type为application/json;charset=utf-8。消息接收接口需要进行验签，以确保消息的正确；消息接收接口请求参数和返回数据需要符合规范。由于网络原因、接口响应超时或者要求业务重试，开放平台会重新推送消息。

重新推送消息说明：

重推间隔: 1s 5s 10s 30s 1m 2m 3m 4m 5m 6m 7m 8m 9m 10m 20m 30m 1h 2h，总共重推18次

要求接口具有消息排重功能。`

调用消息接收接口请求参数

字段名称	类型	是否必填	参数位置	示例值	描述
appid	String	是	query	2c10899471c0e6750171cab921e22e48	应用ID
timestamp	Long	是	query	15891606159	发起请求的时间，单位：秒
noncestr	String	是	query	x2dh3kzy	随机字符串，长度32位以内
sign	String	是	query	8a5ff8e7716227d6017162aa1a0a002c	签名
messagekey	String	是	query	202501010800888123456789	消息唯一判断字段
topic	String	是	query	GOODS_CHANGE	用于区分消息类型
body	String	是	body	{"goodsId":"123456"}	消息内容，格式为JSON字符串

返回内容

格式：application/json;charset=utf-8

名称	类型	是否必填	示例	描述
code	String	是	200	返回码
message	String	是	成功	返回信息
success	boolean	是	true	成功或者失败

返回错误码列表

错误码	描述
200	操作成功
其他	操作失败，通知将进行重试

签名规范

签名算法详见接口说明

有以下两点区别：

加密字符串中增加messagekey和topic参数，比如：

appid={appid}&appsecret={appsecret}&body={body}&messagekey={messagekey}&noncestr={noncestr}&timestamp={timestamp}&topic={topic}

QueryString后面增加messagekey和topic参数，比如：

appid=ca5ff8s76e211d12016e21a627530031&messagekey=202501010800888123456789&noncestr=xxxxxx&timestamp=1584430120&topic=GOODS_CHANGE&sign=c6b8ce9e9d4a3a30d7db6e48f4a903efb099d15c

回调通知

概述#

重新推送消息说明：#

调用消息接收接口请求参数#

返回内容#

返回错误码列表#

签名规范#

概述

重新推送消息说明：

调用消息接收接口请求参数

返回内容

返回错误码列表

签名规范