【27】创建提示消息
<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>创建千牛聊天窗口提示标签 仅用于H5消息窗口</li>
</ul>
<h5>DLL调用例子</h5>
<pre><code>Function_SystemMessage(&quot;tb123456&quot;,&quot;Message&quot;,&quot;这是一条提示&quot;,15,true)</code></pre>
<h5>易语言模块调用例子</h5>
<pre><code>SaiNiu.Function.创建提示消息(&quot;tb123456&quot;,&quot;Message&quot;,&quot;这是一条提示&quot;,15,真)</code></pre>
<h5>POST调用例子</h5>
<pre><code>http://127.0.0.1:3030/SaiNiuApi/Function</code></pre>
<pre><code>&amp;post=SystemMessage&amp;data={&quot;userNick&quot;:&quot;tb123456&quot;,&quot;id&quot;:&quot;Message&quot;,&quot;text&quot;:&quot;这是一条提示&quot;,&quot;delayInSeconds&quot;:15,&quot;scrollToBottom&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;">id</td>
<td style="text-align: left;">文本型</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">消息标识,用于区分不同提示语,同一标识会被替换</td>
<td>Message</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;">提示内容</td>
<td>这是一条提示</td>
</tr>
<tr>
<td style="text-align: left;">delayInSeconds</td>
<td style="text-align: left;">整数型</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">延迟N秒后关闭 默认0不关闭</td>
<td>0</td>
</tr>
<tr>
<td style="text-align: left;">scrollToBottom</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;msg&quot;:&quot;调用成功&quot;,&quot;data&quot;:true,&quot;userNick&quot;:&quot;tb123456&quot;,&quot;passkey&quot;:&quot;1731902081936&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;">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>