【第3步】初始化接口调用和回调执行
<p>[TOC]</p>
<h5>接口状态</h5>
<ul>
<li><code>正常</code></li>
</ul>
<h5>框架版本</h5>
<ul>
<li><code>≥ 2.2.0.0</code></li>
</ul>
<h5>更新时间</h5>
<ul>
<li><code>2025/04/22</code></li>
</ul>
<h5>调用额度</h5>
<ul>
<li><code>免额度</code></li>
</ul>
<h5>简要描述</h5>
<ul>
<li>回调事件以及接口调用初始化,需要先执行 Access_init() 默认开启全部连接 HTTP通过轮询接口回调事件</li>
</ul>
<h5>DLL调用例子</h5>
<pre><code>Function_Init (20,true,2030,&amp;connect,&amp;exit,&amp;newsCall,&amp;newsMonitorCall,&amp;orderCall,&amp;eventCall,&amp;newsAMPCall) </code></pre>
<h5>Python调用例子</h5>
<pre><code>def connect(data):
print(&quot;连接 callback called.&quot;)
print(f&quot;接收到的数据: {data.decode(&#039;gbk&#039;)}&quot;)
def exit(data):
print(&quot;退出 callback called.&quot;)
print(f&quot;接收到的数据: {data.decode(&#039;gbk&#039;)}&quot;)
def newsCall(data):
print(&quot;消息回调函数被调用.&quot;)
print(f&quot;接收到的数据: {data.decode(&#039;gbk&#039;)}&quot;)
def newsMonitorCall(data):
print(&quot;消息监控回调函数被调用.&quot;)
print(f&quot;接收到的数据: {data.decode(&#039;gbk&#039;)}&quot;)
def orderCall(data):
print(&quot;订单回调函数被调用.&quot;)
print(f&quot;接收到的数据: {data.decode(&#039;gbk&#039;)}&quot;)
def eventCall(data):
print(&quot;事件回调函数被调用.&quot;)
print(f&quot;接收到的数据: {data.decode(&#039;gbk&#039;)}&quot;)
def newsAMPCall(data):
print(&quot;消息amp回调函数被调用.&quot;)
print(f&quot;接收到的数据: {data.decode(&#039;gbk&#039;)}&quot;)
connect_callback = CALLBACKFUNC(connect)
exit_callback = CALLBACKFUNC(exit)
newsCall_callback = CALLBACKFUNC(newsCall)
newsMonitorCall_callback = CALLBACKFUNC(newsMonitorCall)
orderCall_callback = CALLBACKFUNC(orderCall)
eventCall_callback = CALLBACKFUNC(eventCall)
newsAMPCall_callback = CALLBACKFUNC(newsAMPCall)
Function = sainiuapi.Function_Init(20, True, 8888,
connect_callback,
exit_callback,
newsCall_callback,
newsMonitorCall_callback,
orderCall_callback,
eventCall_callback,
newsAMPCall_callback
)</code></pre>
<h5>易语言模块调用例子</h5>
<pre><code>SaiNiu.Function.初始化(20,真,2030,&amp;客户连接回调,&amp;客户断开回调,&amp;消息接收回调,&amp;远程接收回调,&amp;订单接收回调,&amp;操作事件回调,&amp;群消息回调)</code></pre>
<h5>POST调用例子</h5>
<pre><code>http://127.0.0.1:3030/SaiNiuApi/Function </code></pre>
<pre><code>&amp;post=Init&amp;data={&quot;number&quot;:20,&quot;openStart&quot;:true,&quot;port&quot;:2030} </code></pre>
<h5>POST回调例子</h5>
<p>[获取连接事件](<a href="https://www.showdoc.com.cn/sainiu/11558415178860007">https://www.showdoc.com.cn/sainiu/11558415178860007</a> "获取连接事件")、[获取断开事件](<a href="https://www.showdoc.com.cn/sainiu/11558415279302282">https://www.showdoc.com.cn/sainiu/11558415279302282</a> "获取断开事件")、[获取新消息](<a href="https://www.showdoc.com.cn/sainiu/11558415300707375">https://www.showdoc.com.cn/sainiu/11558415300707375</a> "获取新消息")、[获取远程消息](<a href="https://www.showdoc.com.cn/sainiu/11558415337796569">https://www.showdoc.com.cn/sainiu/11558415337796569</a> "获取远程消息")、[获取订阅消息](<a href="https://www.showdoc.com.cn/sainiu/11558415371410749">https://www.showdoc.com.cn/sainiu/11558415371410749</a> "获取订阅消息")、[获取操作事件](<a href="https://www.showdoc.com.cn/sainiu/11558415342152211">https://www.showdoc.com.cn/sainiu/11558415342152211</a> "获取操作事件")、[获取群消息](<a href="https://www.showdoc.com.cn/sainiu/11558415316516797">https://www.showdoc.com.cn/sainiu/11558415316516797</a> "获取群消息")</p>
<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;">number</td>
<td style="text-align: left;">整数型</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">处理请求事件的线程数量 默认 50 最小为20</td>
<td>20</td>
</tr>
<tr>
<td style="text-align: left;">openStart</td>
<td style="text-align: left;">逻辑型</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">默认开启连接</td>
<td>true</td>
</tr>
<tr>
<td style="text-align: left;">port</td>
<td style="text-align: left;">整数型</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">驱动启动端口 默认8888</td>
<td>2030</td>
</tr>
<tr>
<td style="text-align: left;">connect</td>
<td style="text-align: left;">子程序指针</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">客户连接回调 回调参数1为文本型</td>
<td>&connect</td>
</tr>
<tr>
<td style="text-align: left;">exit</td>
<td style="text-align: left;">子程序指针</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">客户断开回调 回调参数1为文本型</td>
<td>&exit</td>
</tr>
<tr>
<td style="text-align: left;">newsCall</td>
<td style="text-align: left;">子程序指针</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">消息接收回调 回调参数1为文本型</td>
<td>&newsCall</td>
</tr>
<tr>
<td style="text-align: left;">newsMonitorCall</td>
<td style="text-align: left;">子程序指针</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">远程接收回调 回调参数1为文本型</td>
<td>&newsMonitorCall</td>
</tr>
<tr>
<td style="text-align: left;">orderCall</td>
<td style="text-align: left;">子程序指针</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">订单接收回调 回调参数1为文本型</td>
<td>&orderCall</td>
</tr>
<tr>
<td style="text-align: left;">eventCall</td>
<td style="text-align: left;">子程序指针</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">操作事件回调 回调参数1为文本型</td>
<td>&eventCall</td>
</tr>
<tr>
<td style="text-align: left;">newsAMPCall</td>
<td style="text-align: left;">子程序指针</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">群消息回调 回调参数1为文本型</td>
<td>&newsAMPCall</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code>{&quot;code&quot;:200,&quot;msg&quot;:&quot;调用成功&quot;,&quot;passkey&quot;:&quot;1731687354710&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;">msg</td>
<td style="text-align: left;">文本型</td>
<td>结果说明,调用成功或失败原因</td>
</tr>
<tr>
<td style="text-align: left;">passkey</td>
<td style="text-align: left;">文本型</td>
<td>请求完成13位时间戳</td>
</tr>
</tbody>
</table>
<h5>备注</h5>
<h5>connect - 千牛连接回调(无接待旺旺)</h5>
<pre><code>{&quot;type&quot;:&quot;connect_function&quot;,&quot;user&quot;:&quot;tb9403060_2011&quot;,&quot;userUid&quot;:&quot;796978238&quot;,&quot;mainUid&quot;:&quot;796978238&quot;,&quot;currentUser&quot;:null,&quot;version&quot;:&quot;9.72.00N&quot;,&quot;result&quot;:true}</code></pre>
<h5>connect - 千牛连接回调(有接待旺旺)</h5>
<pre><code>{&quot;type&quot;:&quot;connect_function&quot;,&quot;user&quot;:&quot;tb9403060_2011&quot;,&quot;userUid&quot;:&quot;796978238&quot;,&quot;mainUid&quot;:&quot;796978238&quot;,&quot;currentUser&quot;:&quot;{\&quot;uid\&quot;:\&quot;cntaobaotb266770389534\&quot;,\&quot;user_nick\&quot;:\&quot;cntaobaotb266770389534\&quot;,\&quot;securityUID\&quot;:\&quot;2218165087899\&quot;,\&quot;bizDomain\&quot;:\&quot;taobao\&quot;,\&quot;bizType\&quot;:\&quot;11001\&quot;,\&quot;dnick\&quot;:\&quot;tb266770389534\&quot;,\&quot;cid\&quot;:\&quot;2218165087899.1-796978238.1#11001@cntaobao\&quot;}&quot;,&quot;version&quot;:&quot;9.72.00N&quot;,&quot;result&quot;:true}</code></pre>
<h5>newsCall - 收到消息回调(支持文本、图片、语音、卡片、进店渠道、未知消息)</h5>
<pre><code>{&quot;codeType&quot;:&quot;CHAT_RECEIVE_MSG&quot;,&quot;loginNick&quot;:&quot;tb9403060_2011&quot;,&quot;type&quot;:&quot;文本消息&quot;,&quot;templateId&quot;:101,&quot;buyerNick&quot;:&quot;tb266770389534&quot;,&quot;loginId&quot;:&quot;796978238&quot;,&quot;cid&quot;:&quot;2218165087899.1-796978238.1#11001@cntaobao&quot;,&quot;clientId&quot;:&quot;7319352726570139701&quot;,&quot;messageId&quot;:&quot;3463516949309.PNM&quot;,&quot;buyerUid&quot;:&quot;2218165087899&quot;,&quot;sellerId&quot;:&quot;796978238&quot;,&quot;time&quot;:&quot;1745069676902&quot;,&quot;message&quot;:&quot;你好&quot;}</code></pre>
<h5>newsCall - 发出消息回调</h5>
<pre><code>{&quot;codeType&quot;:&quot;CHAT_SEND_MSG&quot;,&quot;loginNick&quot;:&quot;tb9403060_2011&quot;,&quot;type&quot;:&quot;文本消息&quot;,&quot;templateId&quot;:101,&quot;buyerNick&quot;:&quot;tb9403060_2011&quot;,&quot;loginId&quot;:&quot;796978238&quot;,&quot;cid&quot;:&quot;2218165087899.1-796978238.1#11001@cntaobao&quot;,&quot;clientId&quot;:&quot;7319352429256900650&quot;,&quot;messageId&quot;:&quot;3466365215169.PNM&quot;,&quot;buyerUid&quot;:&quot;796978238&quot;,&quot;sellerId&quot;:&quot;796978238&quot;,&quot;time&quot;:&quot;1745069606179&quot;,&quot;message&quot;:&quot;你好&quot;}</code></pre>
<h5>orderCall - 订阅消息回调(9.35以上版本)</h5>
<pre><code>{&quot;type&quot;:&quot;IMBA_RECEIVE_MSG&quot;,&quot;msg&quot;:&quot;订阅通知消息&quot;,&quot;userNick&quot;:&quot;tb9403060_2011&quot;,&quot;data&quot;:{&quot;templateId&quot;:12000,&quot;mcode&quot;:{&quot;clientId&quot;:&quot;09834df4743af0f4474887355c7252fc-796978238-1000&quot;,&quot;messageId&quot;:&quot;4c5WuMR0cQX2I04371&quot;},&quot;sendTime&quot;:&quot;1745069559461&quot;,&quot;sortTimeMicrosecond&quot;:&quot;1745069559461510&quot;,&quot;cid&quot;:{&quot;ccode&quot;:&quot;1000_VU_1618643395859_796978238#3_796978238#3&quot;},&quot;fromid&quot;:{&quot;targetType&quot;:&quot;&quot;,&quot;targetId&quot;:&quot;1618643395859&quot;,&quot;nick&quot;:&quot;&quot;,&quot;display&quot;:&quot;1618643395859&quot;,&quot;portrait&quot;:&quot;pic:impicture|defaultContact?filepath=D%3A%5C%E8%BD%AF%E4%BB%B6%5C%E5%8D%83%E7%89%9B9600%5C9.72.00N%5CResources%2FdefaultContact.png&quot;},&quot;toid&quot;:{&quot;targetType&quot;:&quot;3&quot;,&quot;targetId&quot;:&quot;796978238&quot;,&quot;nick&quot;:&quot;&quot;,&quot;display&quot;:&quot;1618643395859&quot;,&quot;portrait&quot;:&quot;pic:impicture|defaultContact?filepath=D%3A%5C%E8%BD%AF%E4%BB%B6%5C%E5%8D%83%E7%89%9B9600%5C9.72.00N%5CResources%2FdefaultContact.png&quot;},&quot;summary&quot;:&quot;新订单: 买家:tb26677038,赛牛工作台测试专用链接,勿拍不发货,5.00元,1件&quot;,&quot;status&quot;:0,&quot;originalData&quot;:{&quot;msg&quot;:&quot;{\&quot;bizId\&quot;:2537595913438089978,\&quot;bottom\&quot;:\&quot;查看详情\&quot;,\&quot;buyerNick\&quot;:\&quot;tb266770389534\&quot;,\&quot;buyerUID\&quot;:\&quot;2218165087899\&quot;,\&quot;category\&quot;:1,\&quot;categoryType\&quot;:\&quot;0\&quot;,\&quot;cnName\&quot;:\&quot;新订单\&quot;,\&quot;color\&quot;:\&quot;#3089dc\&quot;,\&quot;content\&quot;:[\&quot;买家ID: tb266770389534\&quot;,\&quot;支持用户数:1用户;版本:权限4一年\&quot;,\&quot;金额: 5.00元 ● 数量: 1件 \&quot;],\&quot;extdata\&quot;:[{\&quot;post_fee\&quot;:\&quot;0.00\&quot;,\&quot;num\&quot;:1,\&quot;is_gift_order\&quot;:false,\&quot;hide_change_address_btn\&quot;:false,\&quot;buyer_id\&quot;:\&quot;2218165087899\&quot;,\&quot;title\&quot;:\&quot;赛牛工作台测试专用链接,勿拍不发货\&quot;,\&quot;contact_id\&quot;:\&quot;2218944563389,796978238\&quot;,\&quot;tid\&quot;:2537595913438089978,\&quot;picture\&quot;:\&quot;i1/796978238/O1CN01NU1iSI2Aj3XEff96R_!!796978238.jpg\&quot;,\&quot;buyer_nick\&quot;:\&quot;tb266770389534\&quot;,\&quot;payment\&quot;:\&quot;5.00\&quot;,\&quot;sku_prop\&quot;:\&quot;支持用户数:1用户;版本:权限4一年\&quot;,\&quot;sendImba\&quot;:true}],\&quot;gmtModified\&quot;:1745069559257,\&quot;hasItemPic\&quot;:true,\&quot;hasRead\&quot;:false,\&quot;id\&quot;:1409648198658469753,\&quot;needUseProtocol\&quot;:false,\&quot;openProtocolAction\&quot;:{\&quot;bizData\&quot;:{\&quot;buyer_nick\&quot;:\&quot;tb266770389534\&quot;,\&quot;_task_biz_id_\&quot;:2537595913438089978,\&quot;tid\&quot;:2537595913438089978},\&quot;buttonName\&quot;:\&quot;查看详情\&quot;,\&quot;clickButton\&quot;:true,\&quot;eventName\&quot;:\&quot;tradeDetail\&quot;,\&quot;from\&quot;:\&quot;msg.trade.TradeCreate.0\&quot;},\&quot;pcButtonList\&quot;:[{\&quot;bizData\&quot;:{\&quot;buyer_nick\&quot;:\&quot;tb266770389534\&quot;,\&quot;_task_biz_id_\&quot;:2537595913438089978,\&quot;tid\&quot;:2537595913438089978},\&quot;buttonName\&quot;:\&quot;查看详情\&quot;,\&quot;clickButton\&quot;:true,\&quot;eventName\&quot;:\&quot;tradeDetail\&quot;,\&quot;from\&quot;:\&quot;msg.trade.TradeCreate.0\&quot;}],\&quot;pcOpenProtocolAction\&quot;:{\&quot;bizData\&quot;:{\&quot;buyer_nick\&quot;:\&quot;tb266770389534\&quot;,\&quot;_task_biz_id_\&quot;:2537595913438089978,\&quot;tid\&quot;:2537595913438089978},\&quot;buttonName\&quot;:\&quot;查看详情\&quot;,\&quot;clickButton\&quot;:true,\&quot;eventName\&quot;:\&quot;tradeDetail\&quot;,\&quot;from\&quot;:\&quot;msg.trade.TradeCreate.0\&quot;},\&quot;richText\&quot;:false,\&quot;showType\&quot;:0,\&quot;status\&quot;:\&quot;TradeCreate\&quot;,\&quot;statusNum\&quot;:1,\&quot;thumbnail\&quot;:\&quot;i1/796978238/O1CN01NU1iSI2Aj3XEff96R_!!796978238.jpg\&quot;,\&quot;title\&quot;:\&quot;赛牛工作台测试专用链接,勿拍不发货\&quot;,\&quot;topic\&quot;:\&quot;trade\&quot;,\&quot;userId\&quot;:796978238}&quot;,&quot;cardImgUrl&quot;:&quot;https://img.alicdn.com/bao/album/i1/796978238/O1CN01NU1iSI2Aj3XEff96R_!!796978238.jpg_120x120.jpg&quot;},&quot;ext&quot;:{&quot;summary&quot;:&quot;新订单: 买家:tb26677038,赛牛工作台测试专用链接,勿拍不发货,5.00元,1件&quot;,&quot;pcMsgTemplateType&quot;:&quot;normal&quot;,&quot;msg_feature&quot;:1,&quot;traceType&quot;:&quot;0&quot;,&quot;mapNewTemplateId&quot;:&quot;179001&quot;,&quot;reminder&quot;:{&quot;reminder&quot;:false,&quot;reminderBegin&quot;:0,&quot;reminderEnd&quot;:0},&quot;agoo&quot;:true,&quot;vu_real&quot;:&quot;1528354685635&quot;,&quot;vu_parent&quot;:&quot;1618643395859&quot;,&quot;tag&quot;:&quot;1618643395859&quot;,&quot;customizeMsgAppKeys&quot;:&quot;23524755,23740221,21281452,30452280,30477041,24665152,34969811,34884620&quot;,&quot;bizChainID&quot;:null,&quot;receiverMainUserId&quot;:&quot;&quot;},&quot;extLocal&quot;:{},&quot;selfState&quot;:0,&quot;receiverState&quot;:{&quot;unread&quot;:{&quot;count&quot;:1,&quot;all&quot;:true},&quot;read&quot;:{&quot;count&quot;:0,&quot;all&quot;:false}},&quot;receiverReadDisable&quot;:false,&quot;remind&quot;:{&quot;remindBehavior&quot;:0,&quot;remindType&quot;:0},&quot;loginid&quot;:{&quot;targetType&quot;:&quot;3&quot;,&quot;nick&quot;:&quot;tb9403060_2011&quot;,&quot;display&quot;:&quot;SaiNiu&quot;,&quot;portrait&quot;:&quot;pic:impicture|?filepath=D%3A%5CAliWorkbenchData%5CNewAppData%5CportraitImage%5Ce2%5Ce22b49afa47b7181e17b235dd6c3c02c&quot;,&quot;appkey&quot;:&quot;cntaobao&quot;,&quot;targetId&quot;:&quot;796978238&quot;,&quot;havMainId&quot;:&quot;796978238&quot;},&quot;browserid&quot;:&quot;&quot;},&quot;passkey&quot;:1745069556445}</code></pre>
<h5>orderCall - 订阅消息回调(9.35以下版本)</h5>
<pre><code>{&quot;type&quot;:&quot;IMBA_RECEIVE_MSG_2&quot;,&quot;msg&quot;:&quot;订阅通知消息&quot;,&quot;userNick&quot;:&quot;tb9403060_2011&quot;,&quot;data&quot;:{&quot;msgid&quot;:&quot;4c5Vax90BEYns49427&quot;,&quot;title&quot;:&quot;赛牛工作台测试专用链接,勿拍不发货&quot;,&quot;action&quot;:&quot;{\&quot;event_name\&quot;:\&quot;tradeDetail\&quot;,\&quot;from\&quot;:\&quot;msg.trade.TradeCreate.0\&quot;}&quot;,&quot;topic&quot;:&quot;trade&quot;,&quot;status&quot;:&quot;TradeCreate&quot;,&quot;time&quot;:&quot;1745069243247&quot;,&quot;readed&quot;:false,&quot;content&quot;:&quot;买家ID: tb266770389534&lt;br&gt;支持用户数:1用户;版本:权限4一年&lt;br&gt;金额: 5.00元 ● 数量: 1件 &quot;,&quot;moreContent&quot;:&quot;[{\&quot;post_fee\&quot;:\&quot;0.00\&quot;,\&quot;num\&quot;:1,\&quot;is_gift_order\&quot;:false,\&quot;hide_change_address_btn\&quot;:false,\&quot;buyer_id\&quot;:\&quot;2218165087899\&quot;,\&quot;title\&quot;:\&quot;赛牛工作台测试专用链接,勿拍不发货\&quot;,\&quot;contact_id\&quot;:\&quot;2218944563389,796978238\&quot;,\&quot;tid\&quot;:2537145734963089978,\&quot;picture\&quot;:\&quot;i1/796978238/O1CN01NU1iSI2Aj3XEff96R_!!796978238.jpg\&quot;,\&quot;buyer_nick\&quot;:\&quot;tb266770389534\&quot;,\&quot;payment\&quot;:\&quot;5.00\&quot;,\&quot;sku_prop\&quot;:\&quot;支持用户数:1用户;版本:权限4一年\&quot;,\&quot;sendImba\&quot;:true}]&quot;,&quot;open_action&quot;:&quot;1&quot;,&quot;biz&quot;:&quot;{\&quot;buyer_nick\&quot;:\&quot;tb266770389534\&quot;,\&quot;_task_biz_id_\&quot;:2537145734963089978,\&quot;tid\&quot;:2537145734963089978}&quot;,&quot;is_preview&quot;:false,&quot;pict&quot;:&quot;&quot;,&quot;picture&quot;:&quot;&quot;,&quot;bizId&quot;:&quot;2537145734963089978&quot;,&quot;accountOriId&quot;:&quot;1618643395859&quot;,&quot;tag&quot;:&quot;&quot;,&quot;tpnMsgid&quot;:&quot;1409308701083084291&quot;,&quot;chs_topic&quot;:&quot;订单通知&quot;,&quot;chs_status&quot;:&quot;新订单&quot;,&quot;buyer_nick&quot;:&quot;tb266770389534&quot;,&quot;buyer_uid&quot;:&quot;2218165087899&quot;,&quot;html_content&quot;:&quot;&quot;,&quot;vectContent&quot;:[&quot;买家ID: tb266770389534&quot;,&quot;支持用户数:1用户;版本:权限4一年&quot;,&quot;金额: 5.00元 ● 数量: 1件 &quot;],&quot;extend&quot;:&quot;&quot;},&quot;passkey&quot;:1745069240165}</code></pre>