API接口目录

平台业务

商品API
价格API
库存API
销售准备API
交易API
退货退款API(新)
财务API
店铺API
物流API
促销API
分销API
发票API
招商API
换货API
互动营销API
退货退款API
客服API
平台营销API
风控API
会员通API
账房API
财务记账API
异常码自查工具
suning.custom.msgPush.create 消息实时推送
¥免费

消息实时推送(仅支持APP消息和微信小程序消息)

公共参数
请求参数
名称 类型 是否必须 示例值 描述
snUnionIdStringY69b75ba05b81eab12fa13eeda5da69b75ba1c5b81eab92fa混淆会员编码
msgSceneCodeStringYY00370场景编码
wxMiniProMsgStringN
appIdStringNtestApp小程序appid(必填)
msgContentStringN消息模板内容微信小程序模板所有内容(必填)
templeIdStringNzWiU8DFaL9f14EygPRSyo8ASVaDP-llc60LvUgXNKi8微信小程序模版id(必填)
pageUrlStringN微信小程序内跳转链接地址微信小程序内跳转链接地址
deviceVersionStringN设备版本号设备版本号(仅适用于达尔文小程序)
sceneCodeStringN0场景编码(仅适用于达尔文小程序)
appMsgStringN
titleStringN签到提醒标题(必填)
contentStringN今天还没有签到哦,快来签到吧!消息内容(必填)
actionTypeStringN0操作动作(0:无操作动作 1:标识链接到APP内某个页面 2:采用浏览器方式链接到某个WEB页面)(必填)
actionStringNhttps://cuxiao.suning.com/scms/bhnsj2020.html详情地址(actionType=0:不需要指定 actionType=1:APP页面Code actionType=2:web页url)(必填)
actionParamStringN00060010225305*000600102252*31000051132*33004428539跳转后页面需要的参数(actionType=1时,传参方式由路由提供方确定)
imgUrlStringNhttp://image5.suning.cn/uimg/b2c/newcatentries/0010046166-000000000140028078_1_100x100.jpg图片地址
categoryStringN900消息中心分类(交易物流: 400(物流助手),700(交易提醒),1100(超时订单消息(苏宁小店店主端使用)) 通知提醒: 300(通知服务),500(我的提醒),900(店铺提醒),1000(会员关怀) 互动:800(互动消息) 订阅号:2200(订阅号) 精选活动:600(精选活动))(必填)
receiverTypeStringN0接收人类型(0.会员编号 1.设备token actionType=0此字段无效)
templetStringN1消息展示模板类型(1:纯文本; 2:图片左文字右; 3:图片上文字下; 4: 中间两张图片,标题在上,内容在下; 5:中间一张图,标题在上,内容在下; 6:多条目模板 100-110 (SNYG预留编码) 200-210 (SNXD预留) 12:问答)(必填)
validityDayStringN15消息中心消息有效天数,过期则置灰不可点击(必填)
displayDayStringN15消息中心消息展示天数,过期则该条消息不展示(必填)
remarkStringN备注备注
notifyTypeStringN0消息类型(0-营销消息 1-通知类消息)(必填)
mapExtStringN*

* Key1:xdTitle, value:取浮层标题维护的内容 *

* Key2:xdContent, value:取浮层内容里面添加的内容:文本+变量

消息子弹扩展字段
响应参数
名称 类型 示例值 描述
resultStringY推送消息操作结果
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <createMsgPush>
      <wxMiniProMsg>
        <templeId>zWiU8DFaL9f14EygPRSyo8ASVaDP-llc60LvUgXNKi8</templeId>
        <msgContent>消息模板内容</msgContent>
        <sceneCode>0</sceneCode>
        <appId>testApp</appId>
        <pageUrl>微信小程序内跳转链接地址</pageUrl>
        <deviceVersion>设备版本号</deviceVersion>
      </wxMiniProMsg>
      <msgSceneCode>Y00370</msgSceneCode>
      <appMsg>
        <validityDay>15</validityDay>
        <templet>1</templet>
        <displayDay>15</displayDay>
        <remark>备注</remark>
        <title>签到提醒</title>
        <content>今天还没有签到哦,快来签到吧!</content>
        <mapExt>* &lt;p&gt; * Key1:xdTitle, value:取浮层标题维护的内容 * &lt;p&gt; * Key2:xdContent, value:取浮层内容里面添加的内容:文本+变量</mapExt>
        <imgUrl>http://image5.suning.cn/uimg/b2c/newcatentries/0010046166-000000000140028078_1_100x100.jpg</imgUrl>
        <actionType>0</actionType>
        <notifyType>0</notifyType>
        <receiverType>0</receiverType>
        <action>https://cuxiao.suning.com/scms/bhnsj2020.html</action>
        <category>900</category>
        <actionParam>00060010225305*000600102252*31000051132*33004428539</actionParam>
      </appMsg>
      <snUnionId>69b75ba05b81eab12fa13eeda5da69b75ba1c5b81eab92fa</snUnionId>
    </createMsgPush>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "createMsgPush": {
        "wxMiniProMsg": {
          "templeId": "zWiU8DFaL9f14EygPRSyo8ASVaDP-llc60LvUgXNKi8",
          "msgContent": "消息模板内容",
          "sceneCode": "0",
          "appId": "testApp",
          "pageUrl": "微信小程序内跳转链接地址",
          "deviceVersion": "设备版本号"
        },
        "msgSceneCode": "Y00370",
        "appMsg": {
          "validityDay": "15",
          "templet": "1",
          "displayDay": "15",
          "remark": "备注",
          "title": "签到提醒",
          "content": "今天还没有签到哦,快来签到吧!",
          "mapExt": "* 

* Key1:xdTitle, value:取浮层标题维护的内容 *

* Key2:xdContent, value:取浮层内容里面添加的内容:文本+变量", "imgUrl": "http://image5.suning.cn/uimg/b2c/newcatentries/0010046166-000000000140028078_1_100x100.jpg", "actionType": "0", "notifyType": "0", "receiverType": "0", "action": "https://cuxiao.suning.com/scms/bhnsj2020.html", "category": "900", "actionParam": "00060010225305*000600102252*31000051132*33004428539" }, "snUnionId": "69b75ba05b81eab12fa13eeda5da69b75ba1c5b81eab92fa" } } } }

响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <createMsgPush>
      <result>Y</result>
    </createMsgPush>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "createMsgPush": {
        "result": "Y"
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.custom.createmsgPush.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.custom.createmsgPush.enumeration-error:* 参数的可选值错误 请检查此参数的值,*号表示参数字段名
biz.custom.createmsgPush.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.custom.createpushmsg.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.xhwmp 服务不可用 请联系苏宁技术人员
公共异常码
API工具
FAQ