添加队列

请求URL:

  • http://server:5999/api/addQueue

请求方式:

  • POST

参数:

参数名 必选 类型 说明
queue_name string 队列名,英文+数字,不要出现中文
type string 类型。可以是”real_time”、”timing”、”variable” ,分别对应实时队列、定时队列、可变队列。如果是可变队列,则会对执行任务的返回结果有要求。请参考添加任务接口的备注说明部分
app_key string 请填写config.json里的app_key以供认证。初次安装HTQ可更改默认的值以提高安全性。更改后需要重启HTQ以生效
app_token string 请填写config.json里的app_token以供认证。初次安装HTQ可更改默认的值以提高安全性。更改后需要重启HTQ以生效
stepping_time int 步进时间,单位是秒。当队列类型是可变队列的时候请传此参数。可变队列的执行机制请参考下文的备注部分。了解执行机制能让你更清晰地知道该如何设置此值
max_time_interval int 最大时间间隔,当队列类型是可变队列的时候请传此参数。可变队列的执行机制请参考下文的备注部分 。了解执行机制能让你更清晰地知道该如何设置此值

成功返回示例

{ 
     "error_code" : 0, 
     "message" : "添加成功" 
 }

失败返回示例

{ 
     "error_code" : 1000, 
     "message" : "认证失败" 
 }

可变队列的执行机制

可变队列的某个任务进入队列后,其url会被触发访问。URL执行的页面若返回字符串”reset”( 即直接在url的页面打印”reset”,如命令 print(“reset”) ),则任务的执行时间间隔会重置。若返回字符串”done”,则结束并删除当前任务.其他情况,URl都会被延迟下一次执行。延迟的时间计算公式是:执行次数 X 步进时间(stepping_time) 。其中,延迟时间最大值为max_time_interval。

所以,当URl没有被重置或者结束的时候,它会慢慢地增大下次执行时间,变得越来越慢,最后达到最大间隔时间max_time_interval后将一直保持这个执行时间间隔。直至得到重置命令或者结束命令.