【20】设置消息订阅
<p>[TOC]</p>
<h5>接口状态</h5>
<ul>
<li><code>正常</code></li>
</ul>
<h5>框架版本</h5>
<ul>
<li><code>≥ 2.0.5.0</code></li>
</ul>
<h5>更新时间</h5>
<ul>
<li><code>2024/11/16</code></li>
</ul>
<h5>调用额度</h5>
<ul>
<li><code>免额度</code></li>
</ul>
<h5>简要描述</h5>
<ul>
<li>设置通知订阅,订单监听需要开启全量消息权限并订阅ID后才能回调成功</li>
</ul>
<h5>DLL调用例子</h5>
<pre><code>Function_MessageSubscription(&quot;tb123456&quot;,1618643395859,true)</code></pre>
<h5>易语言模块调用例子</h5>
<pre><code>SaiNiu.Function.设置消息订阅(&quot;tb123456&quot;,1618643395859,真)</code></pre>
<h5>POST调用例子</h5>
<pre><code>http://127.0.0.1:3030/SaiNiuApi/Function</code></pre>
<pre><code>&amp;post=MessageSubscription&amp;data={&quot;userNick&quot;:&quot;tb123456&quot;,&quot;operateTarget&quot;:1618643395859,&quot;subscribe&quot;:true}</code></pre>
<h5>参数</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">是否必填</th>
<th style="text-align: left;">说明</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">userNick</td>
<td style="text-align: left;">文本型</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">千牛账号</td>
<td>tb123456</td>
</tr>
<tr>
<td style="text-align: left;">operateTarget</td>
<td style="text-align: left;">长整数型</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">订阅id,通过常量 #消息订阅_ 获取</td>
<td>1618643395859</td>
</tr>
<tr>
<td style="text-align: left;">subscribe</td>
<td style="text-align: left;">逻辑型</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">是否订阅</td>
<td>true</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code>{&quot;code&quot;:200,&quot;data&quot;:{&quot;errorCode&quot;:0,&quot;result&quot;:{&quot;noticeType&quot;:1}},&quot;ret&quot;:[&quot;SUCCESS::调用成功&quot;]}</code></pre>
<h5>返回参数说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">code</td>
<td style="text-align: left;">整数型</td>
<td>返回结果,成功=200,失败≠200</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">文本型</td>
<td>请求返回</td>
</tr>
<tr>
<td style="text-align: left;">ret</td>
<td style="text-align: left;">文本型</td>
<td>结果说明,调用成功或失败原因</td>
</tr>
</tbody>
</table>
<h5>订阅消息id</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">订阅类</th>
<th style="text-align: left;">通知类型</th>
<th>订阅通知id</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">重要</td>
<td style="text-align: left;">处罚通知</td>
<td>1618646544898</td>
</tr>
<tr>
<td style="text-align: left;">重要</td>
<td style="text-align: left;">预警通知</td>
<td>1618646522532</td>
</tr>
<tr>
<td style="text-align: left;">重要</td>
<td style="text-align: left;">规则及政策</td>
<td>1618646601718</td>
</tr>
<tr>
<td style="text-align: left;">重要</td>
<td style="text-align: left;">侵权通知</td>
<td>1618646583262</td>
</tr>
<tr>
<td style="text-align: left;">重要</td>
<td style="text-align: left;">申诉及撤消提醒</td>
<td>1618646566646</td>
</tr>
<tr>
<td style="text-align: left;">重要</td>
<td style="text-align: left;">小二通知</td>
<td>1618646665976</td>
</tr>
<tr>
<td style="text-align: left;">重要</td>
<td style="text-align: left;">千牛烽火台</td>
<td>1618644427992</td>
</tr>
<tr>
<td style="text-align: left;">重要</td>
<td style="text-align: left;">商家调研</td>
<td>1618646684258</td>
</tr>
<tr>
<td style="text-align: left;">重要</td>
<td style="text-align: left;">内容中心消息</td>
<td>1673592030481</td>
</tr>
<tr>
<td style="text-align: left;">订单通知</td>
<td style="text-align: left;">新订单</td>
<td>1618643395859</td>
</tr>
<tr>
<td style="text-align: left;">订单通知</td>
<td style="text-align: left;">买家已付款</td>
<td>1618643467718</td>
</tr>
<tr>
<td style="text-align: left;">订单通知</td>
<td style="text-align: left;">卖家已发货</td>
<td>1619755158330</td>
</tr>
<tr>
<td style="text-align: left;">订单通知</td>
<td style="text-align: left;">子订单变动</td>
<td>1618053830909</td>
</tr>
<tr>
<td style="text-align: left;">订单通知</td>
<td style="text-align: left;">交易关闭</td>
<td>1618643435039</td>
</tr>
<tr>
<td style="text-align: left;">订单通知</td>
<td style="text-align: left;">已延迟收货时间</td>
<td>1618643497002</td>
</tr>
<tr>
<td style="text-align: left;">订单通知</td>
<td style="text-align: left;">确认收货超时</td>
<td>1618644427992</td>
</tr>
<tr>
<td style="text-align: left;">订单通知</td>
<td style="text-align: left;">交易成功</td>
<td>1618644403104</td>
</tr>
<tr>
<td style="text-align: left;">订单通知</td>
<td style="text-align: left;">评价通知</td>
<td>1618644452099</td>
</tr>
<tr>
<td style="text-align: left;">订单通知</td>
<td style="text-align: left;">负面通知</td>
<td>1627894541232</td>
</tr>
<tr>
<td style="text-align: left;">订单通知</td>
<td style="text-align: left;">飞猪通知</td>
<td>1618644471305</td>
</tr>
<tr>
<td style="text-align: left;">订单通知</td>
<td style="text-align: left;">退款退货</td>
<td>1622791531182</td>
</tr>
<tr>
<td style="text-align: left;">退款及售后</td>
<td style="text-align: left;">新退款申请</td>
<td>1618644728818</td>
</tr>
<tr>
<td style="text-align: left;">退款及售后</td>
<td style="text-align: left;">投诉维权</td>
<td>1618644505635</td>
</tr>
<tr>
<td style="text-align: left;">退款及售后</td>
<td style="text-align: left;">售后退款即将超时</td>
<td>1618644821631</td>
</tr>
<tr>
<td style="text-align: left;">退款及售后</td>
<td style="text-align: left;">买家修改退款协议</td>
<td>1618644787035</td>
</tr>
<tr>
<td style="text-align: left;">退款及售后</td>
<td style="text-align: left;">买家退货给卖家</td>
<td>1618644803564</td>
</tr>
<tr>
<td style="text-align: left;">退款及售后</td>
<td style="text-align: left;">卖家已同意退款协议</td>
<td>1618644747329</td>
</tr>
<tr>
<td style="text-align: left;">退款及售后</td>
<td style="text-align: left;">卖家已拒绝退款协议</td>
<td>1618644770015</td>
</tr>
<tr>
<td style="text-align: left;">退款及售后</td>
<td style="text-align: left;">退款已关闭</td>
<td>1619755216677</td>
</tr>
<tr>
<td style="text-align: left;">退款及售后</td>
<td style="text-align: left;">退款已完成</td>
<td>1618644488601</td>
</tr>
<tr>
<td style="text-align: left;">仓储物流</td>
<td style="text-align: left;">物流提醒</td>
<td>1618642641540</td>
</tr>
<tr>
<td style="text-align: left;">仓储物流</td>
<td style="text-align: left;">电子面单</td>
<td>1618643349319</td>
</tr>
<tr>
<td style="text-align: left;">仓储物流</td>
<td style="text-align: left;">异常包裹提醒</td>
<td>1618642594114</td>
</tr>
<tr>
<td style="text-align: left;">店铺</td>
<td style="text-align: left;">基础信息变更</td>
<td>1618644864364</td>
</tr>
<tr>
<td style="text-align: left;">店铺</td>
<td style="text-align: left;">库存卖空通知</td>
<td>1618645087313</td>
</tr>
<tr>
<td style="text-align: left;">店铺</td>
<td style="text-align: left;">待办通知</td>
<td>1618645223455</td>
</tr>
<tr>
<td style="text-align: left;">店铺</td>
<td style="text-align: left;">资金管理</td>
<td>1618645036847</td>
</tr>
<tr>
<td style="text-align: left;">店铺</td>
<td style="text-align: left;">图片版权保护</td>
<td>1618644845250</td>
</tr>
<tr>
<td style="text-align: left;">店铺</td>
<td style="text-align: left;">子账号通知</td>
<td>1618644881108</td>
</tr>
<tr>
<td style="text-align: left;">店铺</td>
<td style="text-align: left;">工具服务提醒</td>
<td>1618644897105</td>
</tr>
<tr>
<td style="text-align: left;">店铺</td>
<td style="text-align: left;">互动评论</td>
<td>1618644915457</td>
</tr>
<tr>
<td style="text-align: left;">店铺</td>
<td style="text-align: left;">生意参谋</td>
<td>1618645003235</td>
</tr>
<tr>
<td style="text-align: left;">店铺</td>
<td style="text-align: left;">货源消息</td>
<td>1618644931726</td>
</tr>
<tr>
<td style="text-align: left;">店铺</td>
<td style="text-align: left;">商家反馈</td>
<td>1618645020124</td>
</tr>
<tr>
<td style="text-align: left;">店铺</td>
<td style="text-align: left;">新商品</td>
<td>1619755243681</td>
</tr>
<tr>
<td style="text-align: left;">店铺</td>
<td style="text-align: left;">商品被删除</td>
<td>1619755283383</td>
</tr>
<tr>
<td style="text-align: left;">店铺</td>
<td style="text-align: left;">问大家</td>
<td>1618645064818</td>
</tr>
<tr>
<td style="text-align: left;">店铺</td>
<td style="text-align: left;">自运营通知</td>
<td>1618645205155</td>
</tr>
<tr>
<td style="text-align: left;">营销</td>
<td style="text-align: left;">活动邀约</td>
<td>1618645260815</td>
</tr>
<tr>
<td style="text-align: left;">营销</td>
<td style="text-align: left;">活动审核及排期</td>
<td>1618645242079</td>
</tr>
<tr>
<td style="text-align: left;">营销</td>
<td style="text-align: left;">淘金币</td>
<td>1618646257396</td>
</tr>
<tr>
<td style="text-align: left;">营销</td>
<td style="text-align: left;">阿里认证</td>
<td>1618646412522</td>
</tr>
<tr>
<td style="text-align: left;">营销</td>
<td style="text-align: left;">培训通知</td>
<td>1618646431742</td>
</tr>
<tr>
<td style="text-align: left;">营销</td>
<td style="text-align: left;">淘宝大学</td>
<td>1618646476828</td>
</tr>
<tr>
<td style="text-align: left;">营销</td>
<td style="text-align: left;">权益通知</td>
<td>1618646495168</td>
</tr>
<tr>
<td style="text-align: left;">营销</td>
<td style="text-align: left;">千牛头条</td>
<td>1618646451481</td>
</tr>
<tr>
<td style="text-align: left;">天猫早知道</td>
<td style="text-align: left;">电商在线</td>
<td>1528354808836</td>
</tr>
<tr>
<td style="text-align: left;">千牛</td>
<td style="text-align: left;">公告</td>
<td>1528354582912</td>
</tr>
<tr>
<td style="text-align: left;">千牛</td>
<td style="text-align: left;">反馈</td>
<td>1528354583026</td>
</tr>
<tr>
<td style="text-align: left;">千牛</td>
<td style="text-align: left;">活动</td>
<td>1528354583158</td>
</tr>
<tr>
<td style="text-align: left;">千牛</td>
<td style="text-align: left;">课堂</td>
<td>1528354583282</td>
</tr>
<tr>
<td style="text-align: left;">淘宝小课</td>
<td style="text-align: left;">目标达成</td>
<td>1528354726002</td>
</tr>
<tr>
<td style="text-align: left;">淘宝小课</td>
<td style="text-align: left;">量子学堂</td>
<td>1528354726128</td>
</tr>
<tr>
<td style="text-align: left;">淘宝小课</td>
<td style="text-align: left;">量子日报</td>
<td>1528354726266</td>
</tr>
<tr>
<td style="text-align: left;">淘宝小课</td>
<td style="text-align: left;">波动预警</td>
<td>1528354726397</td>
</tr>
</tbody>
</table>
<h5>备注</h5>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>