Fecify-队列-检查处理结果
基础-获取队列测试状态
接口信息
- 接口地址:
{your-site-url}/api/skill/base/get-test-queue-status
- 基础 URL:
{your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/admin
- 请求方式:
GET
- Content-Type:
application/json
- 配对接口: Fecify-队列-发送请求
- 使用流程: 先调用发送接口 → 获取
job_key → 调用本接口轮询（间隔 1 秒，最多 10 次）→ 过程中任意一次返回成功即停止 → 10 次仍未成功则判定失败
- 说明: 配合发送测试任务接口共同检测 Redis 队列配置是否正常工作。
认证
请求头中需要携带 skill-access-token：
| Header |
值 |
skill-access-token |
{your-skill-access-token} （请替换为你自己的 token） |
请求参数
| 字段 |
类型 |
必填 |
说明 |
job_key |
String |
是 |
队列任务唯一标识，来自 Fecify-队列-发送请求 接口返回的 data.job_key |
请求示例
cURL
curl --location --request GET '{your-site-url}/api/skill/base/get-test-queue-status?job_key=1dbee949c400b8172651adf8cbf9e8c0' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json'
返回结果
返回结果分为两种状态：
队列正在执行（未完成）
{
"code": 102702002,
"data": [],
"message": "队列job 正在执行"
}
队列执行完成
{
"code": 200,
"data": {
"send_time": 1784524890.841223,
"complete_time": 1784524891.237014,
"use_time": 0.395791
},
"message": "success"
}
返回字段说明
通用字段
| 字段 |
类型 |
说明 |
code |
Number |
状态码，200 表示执行完成；102702002 表示队列仍在执行中 |
message |
String |
执行结果的文字描述 |
data 子字段（仅 code=200 时返回）
| 字段 |
类型 |
说明 |
send_time |
Number |
时间戳（带毫秒小数），发送队列请求的时间 |
complete_time |
Number |
时间戳（带毫秒小数），队列处理完成的时间 |
use_time |
Number |
队列处理耗时（秒），即 complete_time - send_time |
轮询检测流程
第 1 次请求 → 失败（code=102702002）→ 等待 1 秒
第 2 次请求 → 失败（code=102702002）→ 等待 1 秒
第 3 次请求 → 成功（code=200） → 停止，返回：队列检查成功
...
第 10 次请求 → 仍失败（code=102702002）→ 停止，返回：队列检查失败
注意事项
job_key 必须与 Fecify-队列-发送请求 返回的 job_key 完全一致，否则无法查询到对应任务。- 轮询间隔为 1 秒，最多请求 10 次，总耗时不超过 10 秒。
- 任意一次返回
code=200 即表示队列正常，无需继续轮询。
- 第 10 次仍返回
code=102702002 则判定队列检查失败，需检查 Redis 连接配置。
use_time 为秒级耗时，数值越小说明队列处理越快。