添加任务到队列
<p><strong>请求URL:</strong> </p>
<ul>
<li><code>http://server:5999/api/addTask</code></li>
</ul>
<p><strong>请求方式:</strong></p>
<ul>
<li>POST </li>
</ul>
<p><strong>参数:</strong> </p>
<table>
<thead>
<tr>
<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;">queue_name</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>队列名。如果不填此参数,则默认添加进系统创建的实时队列里面去</td>
</tr>
<tr>
<td style="text-align: left;">url</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>如 <code>http://www.showdoc.cc/index.php?test=123&ff=22</code></td>
</tr>
<tr>
<td style="text-align: left;">app_key</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>请填写config.json里的app_key以供认证。初次安装HTQ可更改默认的值以提高安全性。更改后需要重启HTQ以生效</td>
</tr>
<tr>
<td style="text-align: left;">app_token</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>请填写config.json里的app_token以供认证。初次安装HTQ可更改默认的值以提高安全性。更改后需要重启HTQ以生效</td>
</tr>
<tr>
<td style="text-align: left;">execute_time</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>执行时间(可选),如"2026-08-21 10:21:12" 。当队列类型为定时队列的时候请传此参数。</td>
</tr>
</tbody>
</table>
<p><strong>成功返回示例</strong></p>
<pre><code>{
"error_code" : 0,
"message" : "添加成功"
}
</code></pre>
<p><strong>失败返回示例</strong></p>
<pre><code>{
"error_code" : 1000,
"message" : "认证失败"
}
</code></pre>
<p><strong>备注说明</strong></p>
<p>当队列是可变队列时(type ='variable' ),URL执行的页面若返回字符串"reset",则任务的执行时间间隔会重置。若返回字符串"done",则结束并删除当前任务.</p>