【17】发送文本消息
<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>2025/04/24</code></li>
</ul>
<h5>调用额度</h5>
<ul>
<li><code>免额度</code></li>
</ul>
<h5>简要描述</h5>
<ul>
<li>发送文本消息(函数发送非键鼠模拟，千牛版本≤9.19时，静默发送，千牛版本＞9.19时，需要打开前台窗口发送)</li>
<li>Emoji表情请先进行Unicode编码 😃：\uD83D\uDE03</li>
<li>POST的传递参数textBase64，为Emoji表情请先进行Unicode编码再转为base64 😃：\uD83D\uDE03：XHVEODNEXHVERTAz</li>
<li>POST参数textBase64需要进行base64编码，若编码后的文本存在“+”则需要进行转义为“/+”后提交。</li>
</ul>
<h5>DLL调用例子</h5>
<pre><code>Function_SendMessages(&quot;tb9403060_2011&quot;,&quot;tb266770389534&quot;,&quot;&quot;,&quot;测试消息\uD83D\uDE03&quot;,&quot;cntaobao&quot;,3000)</code></pre>
<h5>易语言模块调用例子</h5>
<pre><code>SaiNiu.Function.发送文本消息(&quot;tb9403060_2011&quot;,&quot;tb266770389534&quot;,&quot;&quot;,&quot;测试消息\uD83D\uDE03&quot;,&quot;cntaobao&quot;,3000)</code></pre>
<h5>POST调用例子 textBase64 参数会优先于 text</h5>
<pre><code>http://127.0.0.1:3030/SaiNiuApi/Function</code></pre>
<pre><code>&amp;post=SendMessages&amp;data={&quot;userNick&quot;:&quot;tb9403060_2011&quot;,&quot;buyerNick&quot;:&quot;tb266770389534&quot;,&quot;buyerUid&quot;:&quot;&quot;,&quot;textBase64&quot;:&quot;suLK1M/7z6JcdUQ4M0RcdURFMDM=&quot;,&quot;text&quot;:&quot;测试消息&quot;,&quot;siteid&quot;:&quot;cntaobao&quot;,&quot;waitingTime&quot;:3000}</code></pre>
<h5>Python调用例子</h5>
<pre><code>import requests
url = &quot;http://127.0.0.1:3030/SaiNiuApi/Function&quot;
data = {
&#039;post&#039;: &#039;SendMessages&#039;,
&#039;data&#039;:json.dumps({
&quot;userNick&quot;:&quot;tb123456&quot;,
&quot;buyerNick&quot;:&quot;tb456789&quot;,
&quot;buyerUid&quot;:&quot;456789000&quot;,
&quot;text&quot;:&quot;测试消息&quot;,
&quot;textBase64&quot;:&quot;suLK1M/7z6JcdUQ4M0RcdURFMDM=&quot;,
&quot;siteid&quot;:&quot;cntaobao&quot;,
&quot;waitingTime&quot;:3000
})
}
response = requests.post(url, data=data)
print(&#039;返回结果&#039;, response.text)
</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;">buyerNick</td>
<td style="text-align: left;">文本型</td>
<td style="text-align: left;">Nick和Uid二选一</td>
<td style="text-align: left;">接收对象旺旺</td>
<td>tb456789</td>
</tr>
<tr>
<td style="text-align: left;">buyerUid</td>
<td style="text-align: left;">文本型</td>
<td style="text-align: left;">Nick和Uid二选一</td>
<td style="text-align: left;">接收对象旺旺Uid</td>
<td>456789000</td>
</tr>
<tr>
<td style="text-align: left;">text</td>
<td style="text-align: left;">文本型</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">发送内容 富文本转ansi编码</td>
<td>测试消息\uD83D\uDE03</td>
</tr>
<tr>
<td style="text-align: left;">textBase64</td>
<td style="text-align: left;">文本型</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">POST参数，代替text传递富文本，ansi格式进行base64编码，和text同时传递优先textBase64。</td>
<td>“测试消息\uD83D\uDE03”编码后“suLK1M/7z6JcdUQ4M0RcdURFMDM=”</td>
</tr>
<tr>
<td style="text-align: left;">siteid</td>
<td style="text-align: left;">文本型</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">淘宝=cntaobao,1688=cnalichn,留空默认淘宝</td>
<td>cntaobao</td>
</tr>
<tr>
<td style="text-align: left;">waitingTime</td>
<td style="text-align: left;">整数型</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">等待窗口打开超时时间,单位毫秒</td>
<td>3000</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code>{&quot;code&quot;:200,&quot;msg&quot;:&quot;调用成功&quot;,&quot;app_v&quot;:&quot;2.2.5.0&quot;,&quot;data&quot;:true,&quot;reg&quot;:&quot;发送成功&quot;,&quot;userNick&quot;:&quot;tb9403060_2011&quot;,&quot;passkey&quot;:&quot;1747125827097&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;">data</td>
<td style="text-align: left;">逻辑型</td>
<td>调用结果</td>
</tr>
<tr>
<td style="text-align: left;">reg</td>
<td style="text-align: left;">文本型</td>
<td>发送结果</td>
</tr>
<tr>
<td style="text-align: left;">userNick</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>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>